selenium-webdriver 2.48.2 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (524) hide show
  1. package/CHANGES.md +57 -0
  2. package/NOTICE +1 -1
  3. package/README.md +56 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +79 -87
  12. package/firefox/extension.js +10 -18
  13. package/firefox/index.js +173 -173
  14. package/firefox/profile.js +220 -240
  15. package/http/index.js +396 -79
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +88 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +5 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/{webdriver/promise.js → promise.js} +688 -644
  34. package/lib/session.js +79 -0
  35. package/lib/{webdriver/serializable.js → symbols.js} +11 -16
  36. package/lib/test/build.js +4 -4
  37. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  38. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  39. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  40. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  41. package/lib/test/data/readOnlyPage.html +1 -1
  42. package/lib/test/data/selectPage.html +18 -2
  43. package/lib/test/fileserver.js +3 -4
  44. package/lib/test/index.js +7 -3
  45. package/lib/test/resources.js +1 -1
  46. package/lib/until.js +428 -0
  47. package/lib/webdriver.js +2351 -0
  48. package/net/portprober.js +15 -11
  49. package/opera.js +295 -314
  50. package/package.json +6 -5
  51. package/phantomjs.js +135 -140
  52. package/proxy.js +6 -4
  53. package/remote/index.js +229 -221
  54. package/safari.js +319 -310
  55. package/test/chrome/options_test.js +11 -9
  56. package/test/element_finding_test.js +51 -13
  57. package/test/error_test.js +163 -0
  58. package/test/execute_script_test.js +1 -1
  59. package/test/http/http_test.js +317 -55
  60. package/test/http/util_test.js +25 -23
  61. package/test/io_test.js +6 -1
  62. package/test/lib/by_test.js +127 -0
  63. package/test/lib/capabilities_test.js +84 -0
  64. package/test/lib/events_test.js +177 -0
  65. package/test/lib/logging_test.js +272 -0
  66. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  67. package/test/lib/promise_error_test.js +808 -0
  68. package/test/lib/promise_flow_test.js +2282 -0
  69. package/test/lib/promise_generator_test.js +308 -0
  70. package/test/lib/promise_test.js +996 -0
  71. package/test/lib/testutil.js +90 -0
  72. package/test/lib/until_test.js +436 -0
  73. package/test/lib/webdriver_test.js +2207 -0
  74. package/test/page_loading_test.js +7 -9
  75. package/test/stale_element_test.js +2 -2
  76. package/test/testing/assert_test.js +374 -0
  77. package/test/testing/index_test.js +9 -11
  78. package/testing/assert.js +334 -17
  79. package/testing/index.js +10 -0
  80. package/_base.js +0 -200
  81. package/docs/Changes.html +0 -356
  82. package/docs/class_bot_Error.html +0 -15
  83. package/docs/class_webdriver_ActionSequence.html +0 -115
  84. package/docs/class_webdriver_Alert.html +0 -24
  85. package/docs/class_webdriver_AlertPromise.html +0 -92
  86. package/docs/class_webdriver_Capabilities.html +0 -60
  87. package/docs/class_webdriver_Command.html +0 -15
  88. package/docs/class_webdriver_EventEmitter.html +0 -35
  89. package/docs/class_webdriver_FileDetector.html +0 -21
  90. package/docs/class_webdriver_Locator.html +0 -12
  91. package/docs/class_webdriver_Serializable.html +0 -9
  92. package/docs/class_webdriver_Session.html +0 -13
  93. package/docs/class_webdriver_TouchSequence.html +0 -49
  94. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  95. package/docs/class_webdriver_WebDriver.html +0 -313
  96. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  97. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  98. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  99. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  100. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  101. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  102. package/docs/class_webdriver_WebElement.html +0 -223
  103. package/docs/class_webdriver_WebElementPromise.html +0 -274
  104. package/docs/class_webdriver_http_Executor.html +0 -22
  105. package/docs/class_webdriver_http_Request.html +0 -12
  106. package/docs/class_webdriver_http_Response.html +0 -13
  107. package/docs/class_webdriver_logging_Entry.html +0 -15
  108. package/docs/class_webdriver_logging_Level.html +0 -55
  109. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  110. package/docs/class_webdriver_logging_Logger.html +0 -119
  111. package/docs/class_webdriver_logging_Preferences.html +0 -8
  112. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  113. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  114. package/docs/class_webdriver_promise_Deferred.html +0 -84
  115. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  116. package/docs/class_webdriver_promise_Promise.html +0 -75
  117. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  118. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  119. package/docs/class_webdriver_testing_Assertion.html +0 -99
  120. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  121. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  122. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  123. package/docs/class_webdriver_until_Condition.html +0 -7
  124. package/docs/dossier.css +0 -1
  125. package/docs/dossier.js +0 -86
  126. package/docs/enum_bot_ErrorCode.html +0 -3
  127. package/docs/enum_bot_Error_State.html +0 -2
  128. package/docs/enum_webdriver_Browser.html +0 -2
  129. package/docs/enum_webdriver_Button.html +0 -2
  130. package/docs/enum_webdriver_Capability.html +0 -33
  131. package/docs/enum_webdriver_CommandName.html +0 -3
  132. package/docs/enum_webdriver_Key.html +0 -12
  133. package/docs/enum_webdriver_logging_Type.html +0 -6
  134. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  135. package/docs/index.html +0 -125
  136. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  137. package/docs/interface_webdriver_http_Client.html +0 -10
  138. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  139. package/docs/module_selenium-webdriver.html +0 -23
  140. package/docs/module_selenium-webdriver__base.html +0 -23
  141. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  142. package/docs/module_selenium-webdriver_builder.html +0 -2
  143. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  144. package/docs/module_selenium-webdriver_chrome.html +0 -90
  145. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  146. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  147. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  148. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  149. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  150. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  151. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  152. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  153. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  154. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  155. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  156. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  157. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  158. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  159. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  160. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  161. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  162. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  163. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  164. package/docs/module_selenium-webdriver_error.html +0 -4
  165. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  166. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  167. package/docs/module_selenium-webdriver_executors.html +0 -10
  168. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  169. package/docs/module_selenium-webdriver_firefox.html +0 -68
  170. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  171. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  172. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  173. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  174. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  175. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  176. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  177. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  178. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_http.html +0 -9
  180. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  181. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  182. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  183. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  184. package/docs/module_selenium-webdriver_http_util.html +0 -17
  185. package/docs/module_selenium-webdriver_ie.html +0 -11
  186. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  187. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  188. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  189. package/docs/module_selenium-webdriver_io.html +0 -37
  190. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  191. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  192. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  193. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  194. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  195. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  196. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  197. package/docs/module_selenium-webdriver_net.html +0 -7
  198. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  199. package/docs/module_selenium-webdriver_opera.html +0 -62
  200. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  201. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  202. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  203. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  204. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  205. package/docs/module_selenium-webdriver_proxy.html +0 -28
  206. package/docs/module_selenium-webdriver_remote.html +0 -8
  207. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  208. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  209. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  210. package/docs/module_selenium-webdriver_safari.html +0 -9
  211. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  212. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  213. package/docs/module_selenium-webdriver_testing.html +0 -74
  214. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  215. package/docs/namespace_bot.html +0 -4
  216. package/docs/namespace_bot_json.html +0 -20
  217. package/docs/namespace_bot_response.html +0 -18
  218. package/docs/namespace_bot_userAgent.html +0 -33
  219. package/docs/namespace_webdriver.html +0 -30
  220. package/docs/namespace_webdriver_By.html +0 -56
  221. package/docs/namespace_webdriver_http.html +0 -6
  222. package/docs/namespace_webdriver_logging.html +0 -70
  223. package/docs/namespace_webdriver_promise.html +0 -688
  224. package/docs/namespace_webdriver_stacktrace.html +0 -17
  225. package/docs/namespace_webdriver_testing.html +0 -7
  226. package/docs/namespace_webdriver_testing_assert.html +0 -9
  227. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  228. package/docs/namespace_webdriver_until.html +0 -82
  229. package/docs/source/_base.js.src.html +0 -1
  230. package/docs/source/builder.js.src.html +0 -1
  231. package/docs/source/chrome.js.src.html +0 -1
  232. package/docs/source/error.js.src.html +0 -1
  233. package/docs/source/executors.js.src.html +0 -1
  234. package/docs/source/firefox/binary.js.src.html +0 -1
  235. package/docs/source/firefox/extension.js.src.html +0 -1
  236. package/docs/source/firefox/index.js.src.html +0 -1
  237. package/docs/source/firefox/profile.js.src.html +0 -1
  238. package/docs/source/http/index.js.src.html +0 -1
  239. package/docs/source/http/util.js.src.html +0 -1
  240. package/docs/source/ie.js.src.html +0 -1
  241. package/docs/source/index.js.src.html +0 -1
  242. package/docs/source/io/exec.js.src.html +0 -1
  243. package/docs/source/io/index.js.src.html +0 -1
  244. package/docs/source/lib/atoms/error.js.src.html +0 -1
  245. package/docs/source/lib/atoms/json.js.src.html +0 -1
  246. package/docs/source/lib/atoms/response.js.src.html +0 -1
  247. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  248. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  249. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  250. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  251. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  252. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  254. package/docs/source/lib/goog/base.js.src.html +0 -1
  255. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  256. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  257. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  261. package/docs/source/lib/goog/deps.js.src.html +0 -1
  262. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  263. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  264. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  265. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  266. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  271. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  272. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  273. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  282. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  283. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  284. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  285. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  286. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  291. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  292. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  293. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  294. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  295. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  296. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  304. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  305. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  306. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  310. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  311. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  314. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  315. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  316. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  318. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  319. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  320. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  322. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  323. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  326. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  327. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  328. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  344. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  345. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  346. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  347. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  348. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  349. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  350. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  351. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  366. package/docs/source/net/index.js.src.html +0 -1
  367. package/docs/source/net/portprober.js.src.html +0 -1
  368. package/docs/source/opera.js.src.html +0 -1
  369. package/docs/source/phantomjs.js.src.html +0 -1
  370. package/docs/source/proxy.js.src.html +0 -1
  371. package/docs/source/remote/index.js.src.html +0 -1
  372. package/docs/source/safari.js.src.html +0 -1
  373. package/docs/source/testing/assert.js.src.html +0 -1
  374. package/docs/source/testing/index.js.src.html +0 -1
  375. package/docs/types.js +0 -1
  376. package/lib/atoms/error.js +0 -202
  377. package/lib/atoms/json.js +0 -80
  378. package/lib/atoms/response.js +0 -110
  379. package/lib/atoms/userAgent.js +0 -257
  380. package/lib/goog/LICENSE +0 -176
  381. package/lib/goog/array/array.js +0 -1654
  382. package/lib/goog/asserts/asserts.js +0 -365
  383. package/lib/goog/async/freelist.js +0 -88
  384. package/lib/goog/async/nexttick.js +0 -241
  385. package/lib/goog/async/run.js +0 -133
  386. package/lib/goog/async/workqueue.js +0 -139
  387. package/lib/goog/base.js +0 -2548
  388. package/lib/goog/debug/debug.js +0 -653
  389. package/lib/goog/debug/entrypointregistry.js +0 -158
  390. package/lib/goog/debug/error.js +0 -63
  391. package/lib/goog/debug/logbuffer.js +0 -148
  392. package/lib/goog/debug/logger.js +0 -873
  393. package/lib/goog/debug/logrecord.js +0 -242
  394. package/lib/goog/deps.js +0 -151
  395. package/lib/goog/disposable/disposable.js +0 -307
  396. package/lib/goog/disposable/idisposable.js +0 -45
  397. package/lib/goog/dom/browserfeature.js +0 -72
  398. package/lib/goog/dom/dom.js +0 -2991
  399. package/lib/goog/dom/nodetype.js +0 -48
  400. package/lib/goog/dom/safe.js +0 -347
  401. package/lib/goog/dom/tagname.js +0 -160
  402. package/lib/goog/dom/tags.js +0 -41
  403. package/lib/goog/dom/vendor.js +0 -96
  404. package/lib/goog/events/browserevent.js +0 -400
  405. package/lib/goog/events/browserfeature.js +0 -85
  406. package/lib/goog/events/event.js +0 -143
  407. package/lib/goog/events/eventid.js +0 -47
  408. package/lib/goog/events/events.js +0 -984
  409. package/lib/goog/events/eventtarget.js +0 -394
  410. package/lib/goog/events/eventtype.js +0 -237
  411. package/lib/goog/events/keycodes.js +0 -427
  412. package/lib/goog/events/listenable.js +0 -335
  413. package/lib/goog/events/listener.js +0 -131
  414. package/lib/goog/events/listenermap.js +0 -308
  415. package/lib/goog/fs/url.js +0 -109
  416. package/lib/goog/functions/functions.js +0 -442
  417. package/lib/goog/html/safehtml.js +0 -757
  418. package/lib/goog/html/safescript.js +0 -234
  419. package/lib/goog/html/safestyle.js +0 -442
  420. package/lib/goog/html/safestylesheet.js +0 -276
  421. package/lib/goog/html/safeurl.js +0 -398
  422. package/lib/goog/html/trustedresourceurl.js +0 -224
  423. package/lib/goog/html/uncheckedconversions.js +0 -232
  424. package/lib/goog/i18n/bidi.js +0 -908
  425. package/lib/goog/iter/iter.js +0 -1302
  426. package/lib/goog/json/json.js +0 -363
  427. package/lib/goog/labs/testing/assertthat.js +0 -58
  428. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  429. package/lib/goog/labs/testing/matcher.js +0 -80
  430. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  431. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  432. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  433. package/lib/goog/labs/useragent/browser.js +0 -341
  434. package/lib/goog/labs/useragent/engine.js +0 -160
  435. package/lib/goog/labs/useragent/platform.js +0 -160
  436. package/lib/goog/labs/useragent/util.js +0 -148
  437. package/lib/goog/log/log.js +0 -197
  438. package/lib/goog/math/box.js +0 -398
  439. package/lib/goog/math/coordinate.js +0 -268
  440. package/lib/goog/math/math.js +0 -451
  441. package/lib/goog/math/rect.js +0 -476
  442. package/lib/goog/math/size.js +0 -227
  443. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  444. package/lib/goog/net/xhrlike.js +0 -124
  445. package/lib/goog/net/xmlhttp.js +0 -246
  446. package/lib/goog/net/xmlhttpfactory.js +0 -67
  447. package/lib/goog/object/object.js +0 -686
  448. package/lib/goog/promise/promise.js +0 -1350
  449. package/lib/goog/promise/resolver.js +0 -48
  450. package/lib/goog/promise/thenable.js +0 -126
  451. package/lib/goog/reflect/reflect.js +0 -77
  452. package/lib/goog/string/const.js +0 -182
  453. package/lib/goog/string/string.js +0 -1599
  454. package/lib/goog/string/typedstring.js +0 -48
  455. package/lib/goog/structs/collection.js +0 -56
  456. package/lib/goog/structs/map.js +0 -457
  457. package/lib/goog/structs/set.js +0 -279
  458. package/lib/goog/structs/structs.js +0 -354
  459. package/lib/goog/style/style.js +0 -2037
  460. package/lib/goog/testing/asserts.js +0 -1278
  461. package/lib/goog/testing/events/events.js +0 -767
  462. package/lib/goog/testing/functionmock.js +0 -175
  463. package/lib/goog/testing/jsunit.js +0 -162
  464. package/lib/goog/testing/loosemock.js +0 -242
  465. package/lib/goog/testing/mock.js +0 -645
  466. package/lib/goog/testing/mockclock.js +0 -606
  467. package/lib/goog/testing/mockcontrol.js +0 -220
  468. package/lib/goog/testing/mockinterface.js +0 -45
  469. package/lib/goog/testing/mockmatchers.js +0 -400
  470. package/lib/goog/testing/objectpropertystring.js +0 -68
  471. package/lib/goog/testing/propertyreplacer.js +0 -262
  472. package/lib/goog/testing/recordfunction.js +0 -215
  473. package/lib/goog/testing/stacktrace.js +0 -594
  474. package/lib/goog/testing/strictmock.js +0 -130
  475. package/lib/goog/testing/testcase.js +0 -1629
  476. package/lib/goog/testing/testrunner.js +0 -440
  477. package/lib/goog/uri/uri.js +0 -1524
  478. package/lib/goog/uri/utils.js +0 -1064
  479. package/lib/goog/useragent/product.js +0 -183
  480. package/lib/goog/useragent/product_isversion.js +0 -144
  481. package/lib/goog/useragent/useragent.js +0 -572
  482. package/lib/webdriver/actionsequence.js +0 -356
  483. package/lib/webdriver/builder.js +0 -207
  484. package/lib/webdriver/capabilities.js +0 -412
  485. package/lib/webdriver/events.js +0 -179
  486. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  487. package/lib/webdriver/http/corsclient.js +0 -133
  488. package/lib/webdriver/http/http.js +0 -525
  489. package/lib/webdriver/http/xhrclient.js +0 -67
  490. package/lib/webdriver/locators.js +0 -257
  491. package/lib/webdriver/logging.js +0 -347
  492. package/lib/webdriver/session.js +0 -74
  493. package/lib/webdriver/stacktrace.js +0 -619
  494. package/lib/webdriver/test/builder_test.js +0 -53
  495. package/lib/webdriver/test/capabilities_test.js +0 -72
  496. package/lib/webdriver/test/events_test.js +0 -203
  497. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  498. package/lib/webdriver/test/http/http_test.js +0 -428
  499. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  500. package/lib/webdriver/test/locators_test.js +0 -59
  501. package/lib/webdriver/test/logging_test.js +0 -85
  502. package/lib/webdriver/test/promise_error_test.js +0 -892
  503. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  504. package/lib/webdriver/test/promise_generator_test.js +0 -323
  505. package/lib/webdriver/test/promise_test.js +0 -2012
  506. package/lib/webdriver/test/stacktrace_test.js +0 -480
  507. package/lib/webdriver/test/test_bootstrap.js +0 -67
  508. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  509. package/lib/webdriver/test/testing/client_test.js +0 -88
  510. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  511. package/lib/webdriver/test/testutil.js +0 -209
  512. package/lib/webdriver/test/testutil_test.js +0 -104
  513. package/lib/webdriver/test/until_test.js +0 -411
  514. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  515. package/lib/webdriver/test/webdriver_test.js +0 -2369
  516. package/lib/webdriver/testing/asserts.js +0 -487
  517. package/lib/webdriver/testing/client.js +0 -179
  518. package/lib/webdriver/testing/jsunit.js +0 -363
  519. package/lib/webdriver/testing/testcase.js +0 -168
  520. package/lib/webdriver/testing/window.js +0 -244
  521. package/lib/webdriver/touchsequence.js +0 -248
  522. package/lib/webdriver/until.js +0 -412
  523. package/lib/webdriver/webdriver.js +0 -2511
  524. package/test/_base_test.js +0 -129
package/docs/namespace_webdriver_stacktrace.html DELETED
@@ -1,17 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>webdriver.stacktrace</title><link href="dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article><div class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l23">View Source</a></div><h1>namespace webdriver.stacktrace</h1><h2>Functions</h2><div id="format" class="function"><div><h3>format(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l552">code »</a></span></h3><p>Formats an error&#39;s stack trace.</p>
2
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error to format.</p>
3
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The formatted error.</p>
4
- </dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l617">code »</a></span></h3><p>Gets the native stack trace if available otherwise follows the call chain.
5
- The generated trace will exclude all frames up to and including the call to
6
- this function.</p>
7
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a>&gt;</code><dd><p>The frames of the stack trace.</p>
8
- </dl></div></div></div></div><hr class="fn-sep"><div id="getStack" class="function"><div><h3>getStack(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l534">code »</a></span></h3><p>Get an error&#39;s stack trace with the error string trimmed.
9
- V8 prepends the string representation of an error to its stack trace.
10
- This function trims the string so that the stack trace can be parsed
11
- consistently with the other JS engines.</p>
12
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error.</p>
13
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The stack trace string.</p>
14
- </dl></div></div></div></div><h2>Properties</h2><div id="BROWSER_SUPPORTED" class="property"><dl><dt><a href="source/lib/webdriver/stacktrace.js.src.html#l87">BROWSER_SUPPORTED</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser supports stack traces.</p>
15
- </dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_stacktrace_Frame.html">Frame</a><dd><p>Class representing one stack frame.</p>
16
- <dt><a href="class_webdriver_stacktrace_Snapshot.html">Snapshot</a><dd><p>Stores a snapshot of the stack trace at the time this instance was created.</p>
17
- </dl></article><nav><h3><a href="index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="types.js"></script><script src="dossier.js"></script>
package/docs/namespace_webdriver_testing.html DELETED
@@ -1,7 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>webdriver.testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l23">View Source</a></div><h1>namespace webdriver.testing</h1><h2>Functions</h2><div id="assert" class="function"><div><h3>assert(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l399">code »</a></span></h3><p>Creates a new assertion.</p>
2
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform an assertion on.</p>
3
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>The new assertion.</p>
4
- </dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_testing_Assertion.html">Assertion</a><dd><p>Utility for performing assertions against a given <code>value</code>.</p>
5
- <dt><a href="class_webdriver_testing_ContainsMatcher.html">ContainsMatcher</a><dd><p>Accepts strins or array-like structures that contain <code>value</code>.</p>
6
- <dt><a href="class_webdriver_testing_NegatedAssertion.html">NegatedAssertion</a><dd><p>An assertion that negates any applied matchers.</p>
7
- </dl></article><nav><h3><a href="index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="types.js"></script><script src="dossier.js"></script>
package/docs/namespace_webdriver_testing_assert.html DELETED
@@ -1,9 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>webdriver.testing.assert</title><link href="dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l399">View Source</a></div><h1>namespace webdriver.testing.assert</h1><p>Creates a new assertion.</p>
2
- <h2>webdriver.testing.assert(<wbr>value)</h2><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform an assertion on.</p>
3
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>The new assertion.</p>
4
- </dl></div></div><h2>Functions</h2><div id="register" class="function"><div><h3>register(<wbr>name, matcherTemplate)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l413">code »</a></span></h3><p>Registers a new assertion to expose from the
5
- <a href="class_webdriver_testing_Assertion.html"><code>webdriver.testing.Assertion</code></a> prototype.</p>
6
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The assertion name.</p>
7
- <dt>matcherTemplate<code>(function(new: goog.labs.testing.Matcher, *): ?|{describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>})</code><dd><p>Either the
8
- matcher constructor to use, or an object literal defining a matcher.</p>
9
- </dl></div></div></div></div></article><nav><h3><a href="index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="types.js"></script><script src="dossier.js"></script>
package/docs/namespace_webdriver_testing_asserts.html DELETED
@@ -1,18 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>webdriver.testing.asserts</title><link href="dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l27">View Source</a></div><h1>namespace webdriver.testing.asserts</h1><h2>Functions</h2><div id="assertThat" class="function"><div><h3>assertThat(<wbr>failureMessageOrActualValue, actualValueOrMatcher, opt_matcher)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l446">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Asserts that a matcher accepts a given value. This function has two
2
- signatures based on the number of arguments:</p>
3
- <p>Two arguments:
4
- assertThat(actualValue, matcher)
5
- Three arguments:
6
- assertThat(failureMessage, actualValue, matcher)</p>
7
- <dl><dt>Deprecated<dd><p>Use webdriver.testing.asserts.assert instead.</p>
8
- </dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>failureMessageOrActualValue<code>*</code><dd><p>Either a failure message or the value
9
- to apply to the given matcher.</p>
10
- <dt>actualValueOrMatcher<code>*</code><dd><p>Either the value to apply to the given
11
- matcher, or the matcher itself.</p>
12
- <dt>opt_matcher<code>?goog.labs.testing.Matcher=</code><dd><p>The matcher to use;
13
- ignored unless this function is invoked with three arguments.</p>
14
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
15
- </dl></div></div></div></div><hr class="fn-sep"><div id="equalTo" class="function"><div><h3>equalTo(<wbr>expected)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l467">code »</a></span></h3><p>Creates an equality matcher.</p>
16
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>expected<code>*</code><dd><p>The expected value.</p>
17
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>goog.labs.testing.Matcher</code><dd><p>The new matcher.</p>
18
- </dl></div></div></div></div></article><nav><h3><a href="index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="types.js"></script><script src="dossier.js"></script>
package/docs/namespace_webdriver_until.html DELETED
@@ -1,82 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>webdriver.until</title><link href="dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article><div class="codelink"><a href="source/lib/webdriver/until.js.src.html#l42">View Source</a></div><h1>namespace webdriver.until</h1><h2>Functions</h2><div id="ableToSwitchToFrame" class="function"><div><h3>ableToSwitchToFrame(<wbr>frame)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l103">code »</a></span></h3><p>Creates a condition that will wait until the input driver is able to switch
2
- to the designated frame. The target frame may be specified as</p>
3
- <ol><li>a numeric index into
4
- <a href="https://developer.mozilla.org/en-US/docs/Web/API/Window.frames">window.frames</a>
5
- for the currently selected frame.</li><li>a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, which must reference a FRAME or IFRAME
6
- element on the current page.</li><li>a locator which may be used to first locate a FRAME or IFRAME on the
7
- current page before attempting to switch to it.</li></ol>
8
- <p>Upon successful resolution of this condition, the driver will be left
9
- focused on the new frame.</p>
10
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>frame<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The frame identifier.</p>
11
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A new condition.</p>
12
- </dl></div></div></div></div><hr class="fn-sep"><div id="alertIsPresent" class="function"><div><h3>alertIsPresent()<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l139">code »</a></span></h3><p>Creates a condition that waits for an alert to be opened. Upon success, the
13
- returned promise will be fulfilled with the handle for the opened alert.</p>
14
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_Alert.html">webdriver.Alert</a>&gt;</code><dd><p>The new condition.</p>
15
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsDisabled" class="function"><div><h3>elementIsDisabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l319">code »</a></span></h3><p>Creates a condition that will wait for the given element to be disabled.</p>
16
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
17
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
18
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsEnabled" class="function"><div><h3>elementIsEnabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l305">code »</a></span></h3><p>Creates a condition that will wait for the given element to be enabled.</p>
19
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
20
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
21
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotSelected" class="function"><div><h3>elementIsNotSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l348">code »</a></span></h3><p>Creates a condition that will wait for the given element to be deselected.</p>
22
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
23
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
24
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotVisible" class="function"><div><h3>elementIsNotVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l289">code »</a></span></h3><p>Creates a condition that will wait for the given element to be in the DOM,
25
- yet not visible to the user.</p>
26
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
27
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
28
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsSelected" class="function"><div><h3>elementIsSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l334">code »</a></span></h3><p>Creates a condition that will wait for the given element to be selected.</p>
29
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
30
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
31
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementIsVisible" class="function"><div><h3>elementIsVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l274">code »</a></span></h3><p>Creates a condition that will wait for the given element to become visible.</p>
32
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
33
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
34
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementLocated" class="function"><div><h3>elementLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l211">code »</a></span></h3><p>Creates a condition that will loop until an element is
35
- <a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
36
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
37
- to use.</p>
38
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code><dd><p>The new condition.</p>
39
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementTextContains" class="function"><div><h3>elementTextContains(<wbr>element, substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l386">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
40
- <a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to contain the given
41
- substring.</p>
42
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
43
- <dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to search for.</p>
44
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
45
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementTextIs" class="function"><div><h3>elementTextIs(<wbr>element, text)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l367">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
46
- <a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match the given
47
- <code>text</code> exactly.</p>
48
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
49
- <dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected text.</p>
50
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
51
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementTextMatches" class="function"><div><h3>elementTextMatches(<wbr>element, regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l405">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
52
- <a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match a regular
53
- expression.</p>
54
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
55
- <dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
56
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
57
- </dl></div></div></div></div><hr class="fn-sep"><div id="elementsLocated" class="function"><div><h3>elementsLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l232">code »</a></span></h3><p>Creates a condition that will loop until at least one element is
58
- <a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
59
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
60
- to use.</p>
61
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>The new
62
- condition.</p>
63
- </dl></div></div></div></div><hr class="fn-sep"><div id="stalenessOf" class="function"><div><h3>stalenessOf(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l253">code »</a></span></h3><p>Creates a condition that will wait for the given element to become stale. An
64
- element is considered stale once it is removed from the DOM, or a new page
65
- has loaded.</p>
66
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element that should become stale.</p>
67
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
68
- </dl></div></div></div></div><hr class="fn-sep"><div id="titleContains" class="function"><div><h3>titleContains(<wbr>substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l176">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to contain
69
- the given substring.</p>
70
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring that should be present in the page
71
- title.</p>
72
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
73
- </dl></div></div></div></div><hr class="fn-sep"><div id="titleIs" class="function"><div><h3>titleIs(<wbr>title)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l157">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
74
- given value.</p>
75
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>title<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected page title.</p>
76
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
77
- </dl></div></div></div></div><hr class="fn-sep"><div id="titleMatches" class="function"><div><h3>titleMatches(<wbr>regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l194">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
78
- given regular expression.</p>
79
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
80
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
81
- </dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_until_Condition.html">Condition</a><dd><p>Defines a condition to</p>
82
- </dl></article><nav><h3><a href="index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="types.js"></script><script src="dossier.js"></script>
package/docs/source/_base.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>_base.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>_base.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements. See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership. The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License. You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied. See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>/**<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @fileoverview The base module responsible for bootstrapping the Closure<tr><td><a id="l20"></a><a href="#l20">20</a><td> * library and providing a means of loading Closure-based modules.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * &lt;p&gt;Each script loaded by this module will be granted access to this module&#39;s<tr><td><a id="l23"></a><a href="#l23">23</a><td> * {@code require} function; all required non-native modules must be specified<tr><td><a id="l24"></a><a href="#l24">24</a><td> * relative to &lt;em&gt;this&lt;/em&gt; module.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * &lt;p&gt;This module will load all scripts from the &quot;lib&quot; subdirectory, unless the<tr><td><a id="l27"></a><a href="#l27">27</a><td> * SELENIUM_DEV_MODE environment variable has been set to 1, in which case all<tr><td><a id="l28"></a><a href="#l28">28</a><td> * scripts will be loaded from the Selenium client containing this script.<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td>&#39;use strict&#39;;<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l34"></a><a href="#l34">34</a><td> path = require(&#39;path&#39;),<tr><td><a id="l35"></a><a href="#l35">35</a><td> vm = require(&#39;vm&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td><tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td>/**<tr><td><a id="l39"></a><a href="#l39">39</a><td> * If this script was loaded from the Selenium project repo, it will operate in<tr><td><a id="l40"></a><a href="#l40">40</a><td> * development mode, adjusting how it loads Closure-based dependencies.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @type {boolean}<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>var devMode = (function() {<tr><td><a id="l44"></a><a href="#l44">44</a><td> var buildDescFile = path.join(__dirname, &#39;..&#39;, &#39;build.desc&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td> return fs.existsSync(buildDescFile);<tr><td><a id="l46"></a><a href="#l46">46</a><td>})();<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>/** @return {boolean} Whether this script was loaded in dev mode. */<tr><td><a id="l50"></a><a href="#l50">50</a><td>function isDevMode() {<tr><td><a id="l51"></a><a href="#l51">51</a><td> return devMode;<tr><td><a id="l52"></a><a href="#l52">52</a><td>}<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @const<tr><td><a id="l58"></a><a href="#l58">58</a><td> */<tr><td><a id="l59"></a><a href="#l59">59</a><td>var CLOSURE_BASE_FILE_PATH = (function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td> var relativePath = isDevMode() ?<tr><td><a id="l61"></a><a href="#l61">61</a><td> &#39;../../../third_party/closure/goog/base.js&#39; :<tr><td><a id="l62"></a><a href="#l62">62</a><td> &#39;./lib/goog/base.js&#39;;<tr><td><a id="l63"></a><a href="#l63">63</a><td> return path.join(__dirname, relativePath);<tr><td><a id="l64"></a><a href="#l64">64</a><td>})();<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @const<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>var DEPS_FILE_PATH = (function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td> var relativePath = isDevMode() ?<tr><td><a id="l73"></a><a href="#l73">73</a><td> &#39;../../../javascript/deps.js&#39; :<tr><td><a id="l74"></a><a href="#l74">74</a><td> &#39;./lib/goog/deps.js&#39;;<tr><td><a id="l75"></a><a href="#l75">75</a><td> return path.join(__dirname, relativePath);<tr><td><a id="l76"></a><a href="#l76">76</a><td>})();<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * Maintains a unique context for Closure library-based code.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {boolean=} opt_configureForTesting Whether to configure a fake DOM<tr><td><a id="l82"></a><a href="#l82">82</a><td> * for Closure-testing code that (incorrectly) assumes a DOM is always<tr><td><a id="l83"></a><a href="#l83">83</a><td> * present.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @constructor<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>function Context(opt_configureForTesting) {<tr><td><a id="l87"></a><a href="#l87">87</a><td> var closure = this.closure = vm.createContext({<tr><td><a id="l88"></a><a href="#l88">88</a><td> console: console,<tr><td><a id="l89"></a><a href="#l89">89</a><td> setTimeout: setTimeout,<tr><td><a id="l90"></a><a href="#l90">90</a><td> setInterval: setInterval,<tr><td><a id="l91"></a><a href="#l91">91</a><td> clearTimeout: clearTimeout,<tr><td><a id="l92"></a><a href="#l92">92</a><td> clearInterval: clearInterval,<tr><td><a id="l93"></a><a href="#l93">93</a><td> process: process,<tr><td><a id="l94"></a><a href="#l94">94</a><td> require: require,<tr><td><a id="l95"></a><a href="#l95">95</a><td> Buffer: Buffer,<tr><td><a id="l96"></a><a href="#l96">96</a><td> Error: Error,<tr><td><a id="l97"></a><a href="#l97">97</a><td> TypeError: TypeError,<tr><td><a id="l98"></a><a href="#l98">98</a><td> CLOSURE_BASE_PATH: path.dirname(CLOSURE_BASE_FILE_PATH) + &#39;/&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td> CLOSURE_IMPORT_SCRIPT: function(src, opt_srcText) {<tr><td><a id="l100"></a><a href="#l100">100</a><td> if (opt_srcText !== undefined) {<tr><td><a id="l101"></a><a href="#l101">101</a><td> // Windows paths use backslashes, which must be properly escaped before<tr><td><a id="l102"></a><a href="#l102">102</a><td> // evaluated with vm.runInContext.<tr><td><a id="l103"></a><a href="#l103">103</a><td> opt_srcText = opt_srcText.replace(/\\/g, &#39;/&#39;);<tr><td><a id="l104"></a><a href="#l104">104</a><td> vm.runInContext(opt_srcText, closure, src);<tr><td><a id="l105"></a><a href="#l105">105</a><td> } else {<tr><td><a id="l106"></a><a href="#l106">106</a><td> loadScript(src);<tr><td><a id="l107"></a><a href="#l107">107</a><td> }<tr><td><a id="l108"></a><a href="#l108">108</a><td> return true;<tr><td><a id="l109"></a><a href="#l109">109</a><td> },<tr><td><a id="l110"></a><a href="#l110">110</a><td> CLOSURE_NO_DEPS: !isDevMode(),<tr><td><a id="l111"></a><a href="#l111">111</a><td> CLOSURE_UNCOMPILED_DEFINES: {&#39;goog.json.USE_NATIVE_JSON&#39;: true},<tr><td><a id="l112"></a><a href="#l112">112</a><td> goog: {}<tr><td><a id="l113"></a><a href="#l113">113</a><td> });<tr><td><a id="l114"></a><a href="#l114">114</a><td> closure.window = closure.top = closure;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td> if (opt_configureForTesting) {<tr><td><a id="l117"></a><a href="#l117">117</a><td> closure.document = {<tr><td><a id="l118"></a><a href="#l118">118</a><td> body: {},<tr><td><a id="l119"></a><a href="#l119">119</a><td> createElement: function() { return {}; },<tr><td><a id="l120"></a><a href="#l120">120</a><td> getElementsByTagName: function() { return []; }<tr><td><a id="l121"></a><a href="#l121">121</a><td> };<tr><td><a id="l122"></a><a href="#l122">122</a><td> closure.document.body.ownerDocument = closure.document;<tr><td><a id="l123"></a><a href="#l123">123</a><td> }<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td> loadScript(CLOSURE_BASE_FILE_PATH);<tr><td><a id="l126"></a><a href="#l126">126</a><td> loadScript(DEPS_FILE_PATH);<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td> // Redefine retrieveAndExecModule_ to load modules. Closure&#39;s version<tr><td><a id="l129"></a><a href="#l129">129</a><td> // assumes XMLHttpRequest is defined (and by extension that scripts<tr><td><a id="l130"></a><a href="#l130">130</a><td> // are being loaded from a server).<tr><td><a id="l131"></a><a href="#l131">131</a><td> closure.goog.retrieveAndExecModule_ = function(src) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> var normalizedSrc = path.normalize(src);<tr><td><a id="l133"></a><a href="#l133">133</a><td> var contents = fs.readFileSync(normalizedSrc, &#39;utf8&#39;);<tr><td><a id="l134"></a><a href="#l134">134</a><td> contents = closure.goog.wrapModule_(src, contents);<tr><td><a id="l135"></a><a href="#l135">135</a><td> vm.runInContext(contents, closure, normalizedSrc);<tr><td><a id="l136"></a><a href="#l136">136</a><td> };<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td> /**<tr><td><a id="l139"></a><a href="#l139">139</a><td> * Synchronously loads a script into the protected Closure context.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string} src Path to the file to load.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td> function loadScript(src) {<tr><td><a id="l143"></a><a href="#l143">143</a><td> src = path.normalize(src);<tr><td><a id="l144"></a><a href="#l144">144</a><td> var contents = fs.readFileSync(src, &#39;utf8&#39;);<tr><td><a id="l145"></a><a href="#l145">145</a><td> vm.runInContext(contents, closure, src);<tr><td><a id="l146"></a><a href="#l146">146</a><td> }<tr><td><a id="l147"></a><a href="#l147">147</a><td>}<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>var context = new Context();<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Loads a symbol by name from the protected Closure context.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {string} symbol The symbol to load.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @return {?} The loaded symbol, or {@code null} if not found.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @throws {Error} If the symbol has not been defined.<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>function closureRequire(symbol) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> context.closure.goog.require(symbol);<tr><td><a id="l161"></a><a href="#l161">161</a><td> return context.closure.goog.getObjectByName(symbol);<tr><td><a id="l162"></a><a href="#l162">162</a><td>}<tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>// PUBLIC API<tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td><tr><td><a id="l168"></a><a href="#l168">168</a><td>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * Loads a symbol by name from the protected Closure context and exports its<tr><td><a id="l170"></a><a href="#l170">170</a><td> * public API to the provided object. This function relies on Closure code<tr><td><a id="l171"></a><a href="#l171">171</a><td> * conventions to define the public API of an object as those properties whose<tr><td><a id="l172"></a><a href="#l172">172</a><td> * name does not end with &quot;_&quot;.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {string} symbol The symbol to load. This must resolve to an object.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!Object} An object with the exported API.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @throws {Error} If the symbol has not been defined or does not resolve to<tr><td><a id="l176"></a><a href="#l176">176</a><td> * an object.<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>exports.exportPublicApi = function(symbol) {<tr><td><a id="l179"></a><a href="#l179">179</a><td> var src = closureRequire(symbol);<tr><td><a id="l180"></a><a href="#l180">180</a><td> if (typeof src != &#39;object&#39; || src === null) {<tr><td><a id="l181"></a><a href="#l181">181</a><td> throw Error(&#39;&quot;&#39; + symbol + &#39;&quot; must resolve to an object&#39;);<tr><td><a id="l182"></a><a href="#l182">182</a><td> }<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td> var dest = {};<tr><td><a id="l185"></a><a href="#l185">185</a><td> Object.keys(src).forEach(function(key) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> if (key[key.length - 1] != &#39;_&#39;) {<tr><td><a id="l187"></a><a href="#l187">187</a><td> dest[key] = src[key];<tr><td><a id="l188"></a><a href="#l188">188</a><td> }<tr><td><a id="l189"></a><a href="#l189">189</a><td> });<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td> return dest;<tr><td><a id="l192"></a><a href="#l192">192</a><td>};<tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td>if (isDevMode()) {<tr><td><a id="l196"></a><a href="#l196">196</a><td> exports.closure = context.closure;<tr><td><a id="l197"></a><a href="#l197">197</a><td>}<tr><td><a id="l198"></a><a href="#l198">198</a><td>exports.Context = Context;<tr><td><a id="l199"></a><a href="#l199">199</a><td>exports.isDevMode = isDevMode;<tr><td><a id="l200"></a><a href="#l200">200</a><td>exports.require = closureRequire;</table></div></article><nav><h3><a href="../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../types.js"></script><script src="../dossier.js"></script>
package/docs/source/builder.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>builder.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>builder.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements. See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership. The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License. You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied. See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>var base = require(&#39;./_base&#39;),<tr><td><a id="l19"></a><a href="#l19">19</a><td> executors = require(&#39;./executors&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>// Use base.require to avoid circular references between index and this module.<tr><td><a id="l22"></a><a href="#l22">22</a><td>var Browser = base.require(&#39;webdriver.Browser&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td> Capabilities = base.require(&#39;webdriver.Capabilities&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td> Capability = base.require(&#39;webdriver.Capability&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td> WebDriver = base.require(&#39;webdriver.WebDriver&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td> promise = base.require(&#39;webdriver.promise&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>var seleniumServer;<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Starts an instance of the Selenium server if not yet running.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} jar Path to the server jar to use.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @return {!webdriver.promise.Promise&lt;string&gt;} A promise for the server&#39;s<tr><td><a id="l36"></a><a href="#l36">36</a><td> * addrss once started.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>function startSeleniumServer(jar) {<tr><td><a id="l39"></a><a href="#l39">39</a><td> if (!seleniumServer) {<tr><td><a id="l40"></a><a href="#l40">40</a><td> // Requiring &#39;chrome&#39; above would create a cycle:<tr><td><a id="l41"></a><a href="#l41">41</a><td> // index -&gt; builder -&gt; chrome -&gt; index<tr><td><a id="l42"></a><a href="#l42">42</a><td> var remote = require(&#39;./remote&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td> seleniumServer = new remote.SeleniumServer(jar);<tr><td><a id="l44"></a><a href="#l44">44</a><td> }<tr><td><a id="l45"></a><a href="#l45">45</a><td> return seleniumServer.start();<tr><td><a id="l46"></a><a href="#l46">46</a><td>}<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * Creates new {@link webdriver.WebDriver WebDriver} instances. The environment<tr><td><a id="l51"></a><a href="#l51">51</a><td> * variables listed below may be used to override a builder&#39;s configuration,<tr><td><a id="l52"></a><a href="#l52">52</a><td> * allowing quick runtime changes.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * - {@code SELENIUM_BROWSER}: defines the target browser in the form<tr><td><a id="l55"></a><a href="#l55">55</a><td> * {@code browser[:version][:platform]}.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * - {@code SELENIUM_REMOTE_URL}: defines the remote URL for all builder<tr><td><a id="l58"></a><a href="#l58">58</a><td> * instances. This environment variable should be set to a fully qualified<tr><td><a id="l59"></a><a href="#l59">59</a><td> * URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This<tr><td><a id="l60"></a><a href="#l60">60</a><td> * option always takes precedence over {@code SELENIUM_SERVER_JAR}.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * - {@code SELENIUM_SERVER_JAR}: defines the path to the<tr><td><a id="l63"></a><a href="#l63">63</a><td> * &lt;a href=&quot;http://selenium-release.storage.googleapis.com/index.html&quot;&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> * standalone Selenium server&lt;/a&gt; jar to use. The server will be started the<tr><td><a id="l65"></a><a href="#l65">65</a><td> * first time a WebDriver instance and be killed when the process exits.<tr><td><a id="l66"></a><a href="#l66">66</a><td> *<tr><td><a id="l67"></a><a href="#l67">67</a><td> * Suppose you had mytest.js that created WebDriver with<tr><td><a id="l68"></a><a href="#l68">68</a><td> *<tr><td><a id="l69"></a><a href="#l69">69</a><td> * var driver = new webdriver.Builder()<tr><td><a id="l70"></a><a href="#l70">70</a><td> * .forBrowser(&#39;chrome&#39;)<tr><td><a id="l71"></a><a href="#l71">71</a><td> * .build();<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * This test could be made to use Firefox on the local machine by running with<tr><td><a id="l74"></a><a href="#l74">74</a><td> * `SELENIUM_BROWSER=firefox node mytest.js`. Rather than change the code to<tr><td><a id="l75"></a><a href="#l75">75</a><td> * target Google Chrome on a remote machine, you can simply set the<tr><td><a id="l76"></a><a href="#l76">76</a><td> * `SELENIUM_BROWSER` and `SELENIUM_REMOTE_URL` environment variables:<tr><td><a id="l77"></a><a href="#l77">77</a><td> *<tr><td><a id="l78"></a><a href="#l78">78</a><td> * SELENIUM_BROWSER=chrome:36:LINUX \<tr><td><a id="l79"></a><a href="#l79">79</a><td> * SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \<tr><td><a id="l80"></a><a href="#l80">80</a><td> * node mytest.js<tr><td><a id="l81"></a><a href="#l81">81</a><td> *<tr><td><a id="l82"></a><a href="#l82">82</a><td> * You could also use a local copy of the standalone Selenium server:<tr><td><a id="l83"></a><a href="#l83">83</a><td> *<tr><td><a id="l84"></a><a href="#l84">84</a><td> * SELENIUM_BROWSER=chrome:36:LINUX \<tr><td><a id="l85"></a><a href="#l85">85</a><td> * SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \<tr><td><a id="l86"></a><a href="#l86">86</a><td> * node mytest.js<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @constructor<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>var Builder = function() {<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td> /** @private {webdriver.promise.ControlFlow} */<tr><td><a id="l93"></a><a href="#l93">93</a><td> this.flow_ = null;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td> /** @private {string} */<tr><td><a id="l96"></a><a href="#l96">96</a><td> this.url_ = &#39;&#39;;<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td> /** @private {?string} */<tr><td><a id="l99"></a><a href="#l99">99</a><td> this.proxy_ = null;<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td> /** @private {!webdriver.Capabilities} */<tr><td><a id="l102"></a><a href="#l102">102</a><td> this.capabilities_ = new Capabilities();<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td> /** @private {chrome.Options} */<tr><td><a id="l105"></a><a href="#l105">105</a><td> this.chromeOptions_ = null;<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td> /** @private {firefox.Options} */<tr><td><a id="l108"></a><a href="#l108">108</a><td> this.firefoxOptions_ = null;<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td> /** @private {opera.Options} */<tr><td><a id="l111"></a><a href="#l111">111</a><td> this.operaOptions_ = null;<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td> /** @private {ie.Options} */<tr><td><a id="l114"></a><a href="#l114">114</a><td> this.ieOptions_ = null;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td> /** @private {safari.Options} */<tr><td><a id="l117"></a><a href="#l117">117</a><td> this.safariOptions_ = null;<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td> /** @private {boolean} */<tr><td><a id="l120"></a><a href="#l120">120</a><td> this.ignoreEnv_ = false;<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Configures this builder to ignore any environment variable overrides and to<tr><td><a id="l126"></a><a href="#l126">126</a><td> * only use the configuration specified through this instance&#39;s API.<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @return {!Builder} A self reference.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>Builder.prototype.disableEnvironmentOverrides = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td> this.ignoreEnv_ = true;<tr><td><a id="l132"></a><a href="#l132">132</a><td> return this;<tr><td><a id="l133"></a><a href="#l133">133</a><td>};<tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td><tr><td><a id="l136"></a><a href="#l136">136</a><td>/**<tr><td><a id="l137"></a><a href="#l137">137</a><td> * Sets the URL of a remote WebDriver server to use. Once a remote URL has been<tr><td><a id="l138"></a><a href="#l138">138</a><td> * specified, the builder direct all new clients to that server. If this method<tr><td><a id="l139"></a><a href="#l139">139</a><td> * is never called, the Builder will attempt to create all clients locally.<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * As an alternative to this method, you may also set the `SELENIUM_REMOTE_URL`<tr><td><a id="l142"></a><a href="#l142">142</a><td> * environment variable.<tr><td><a id="l143"></a><a href="#l143">143</a><td> *<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {string} url The URL of a remote server to use.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {!Builder} A self reference.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>Builder.prototype.usingServer = function(url) {<tr><td><a id="l148"></a><a href="#l148">148</a><td> this.url_ = url;<tr><td><a id="l149"></a><a href="#l149">149</a><td> return this;<tr><td><a id="l150"></a><a href="#l150">150</a><td>};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a id="l155"></a><a href="#l155">155</a><td> * to use.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>Builder.prototype.getServerUrl = function() {<tr><td><a id="l158"></a><a href="#l158">158</a><td> return this.url_;<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Sets the URL of the proxy to use for the WebDriver&#39;s HTTP connections.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * If this method is never called, the Builder will create a connection without<tr><td><a id="l165"></a><a href="#l165">165</a><td> * a proxy.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {string} proxy The URL of a proxy to use.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!Builder} A self reference.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>Builder.prototype.usingWebDriverProxy = function(proxy) {<tr><td><a id="l171"></a><a href="#l171">171</a><td> this.proxy_ = proxy;<tr><td><a id="l172"></a><a href="#l172">172</a><td> return this;<tr><td><a id="l173"></a><a href="#l173">173</a><td>};<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>/**<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @return {string} The URL of the proxy server to use for the WebDriver&#39;s HTTP<tr><td><a id="l178"></a><a href="#l178">178</a><td> * connections.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>Builder.prototype.getWebDriverProxy = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td> return this.proxy_;<tr><td><a id="l182"></a><a href="#l182">182</a><td>};<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a id="l187"></a><a href="#l187">187</a><td> * overwrite any previously set capabilities.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a id="l189"></a><a href="#l189">189</a><td> * capabilities for a new session.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!Builder} A self reference.<tr><td><a id="l191"></a><a href="#l191">191</a><td> */<tr><td><a id="l192"></a><a href="#l192">192</a><td>Builder.prototype.withCapabilities = function(capabilities) {<tr><td><a id="l193"></a><a href="#l193">193</a><td> this.capabilities_ = new Capabilities(capabilities);<tr><td><a id="l194"></a><a href="#l194">194</a><td> return this;<tr><td><a id="l195"></a><a href="#l195">195</a><td>};<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Returns the base set of capabilities this instance is currently configured<tr><td><a id="l200"></a><a href="#l200">200</a><td> * to use.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @return {!webdriver.Capabilities} The current capabilities for this builder.<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>Builder.prototype.getCapabilities = function() {<tr><td><a id="l204"></a><a href="#l204">204</a><td> return this.capabilities_;<tr><td><a id="l205"></a><a href="#l205">205</a><td>};<tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td>/**<tr><td><a id="l209"></a><a href="#l209">209</a><td> * Configures the target browser for clients created by this instance.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Any calls to {@link #withCapabilities} after this function will<tr><td><a id="l211"></a><a href="#l211">211</a><td> * overwrite these settings.<tr><td><a id="l212"></a><a href="#l212">212</a><td> *<tr><td><a id="l213"></a><a href="#l213">213</a><td> * You may also define the target browser using the {@code SELENIUM_BROWSER}<tr><td><a id="l214"></a><a href="#l214">214</a><td> * environment variable. If set, this environment variable should be of the<tr><td><a id="l215"></a><a href="#l215">215</a><td> * form `browser[:[version][:platform]]`.<tr><td><a id="l216"></a><a href="#l216">216</a><td> *<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @param {(string|webdriver.Browser)} name The name of the target browser;<tr><td><a id="l218"></a><a href="#l218">218</a><td> * common defaults are available on the {@link webdriver.Browser} enum.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {string=} opt_version A desired version; may be omitted if any<tr><td><a id="l220"></a><a href="#l220">220</a><td> * version should be used.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {string=} opt_platform The desired platform; may be omitted if any<tr><td><a id="l222"></a><a href="#l222">222</a><td> * version may be used.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!Builder} A self reference.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>Builder.prototype.forBrowser = function(name, opt_version, opt_platform) {<tr><td><a id="l226"></a><a href="#l226">226</a><td> this.capabilities_.set(Capability.BROWSER_NAME, name);<tr><td><a id="l227"></a><a href="#l227">227</a><td> this.capabilities_.set(Capability.VERSION, opt_version || null);<tr><td><a id="l228"></a><a href="#l228">228</a><td> this.capabilities_.set(Capability.PLATFORM, opt_platform || null);<tr><td><a id="l229"></a><a href="#l229">229</a><td> return this;<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Sets the proxy configuration to use for WebDriver clients created by this<tr><td><a id="l235"></a><a href="#l235">235</a><td> * builder. Any calls to {@link #withCapabilities} after this function will<tr><td><a id="l236"></a><a href="#l236">236</a><td> * overwrite these settings.<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @param {!webdriver.ProxyConfig} config The configuration to use.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @return {!Builder} A self reference.<tr><td><a id="l239"></a><a href="#l239">239</a><td> */<tr><td><a id="l240"></a><a href="#l240">240</a><td>Builder.prototype.setProxy = function(config) {<tr><td><a id="l241"></a><a href="#l241">241</a><td> this.capabilities_.setProxy(config);<tr><td><a id="l242"></a><a href="#l242">242</a><td> return this;<tr><td><a id="l243"></a><a href="#l243">243</a><td>};<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td>/**<tr><td><a id="l247"></a><a href="#l247">247</a><td> * Sets the logging preferences for the created session. Preferences may be<tr><td><a id="l248"></a><a href="#l248">248</a><td> * changed by repeated calls, or by calling {@link #withCapabilities}.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a id="l250"></a><a href="#l250">250</a><td> * desired logging preferences.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @return {!Builder} A self reference.<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>Builder.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l254"></a><a href="#l254">254</a><td> this.capabilities_.setLoggingPrefs(prefs);<tr><td><a id="l255"></a><a href="#l255">255</a><td> return this;<tr><td><a id="l256"></a><a href="#l256">256</a><td>};<tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Sets whether native events should be used.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean} enabled Whether to enable native events.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {!Builder} A self reference.<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>Builder.prototype.setEnableNativeEvents = function(enabled) {<tr><td><a id="l265"></a><a href="#l265">265</a><td> this.capabilities_.setEnableNativeEvents(enabled);<tr><td><a id="l266"></a><a href="#l266">266</a><td> return this;<tr><td><a id="l267"></a><a href="#l267">267</a><td>};<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>/**<tr><td><a id="l271"></a><a href="#l271">271</a><td> * Sets how elements should be scrolled into view for interaction.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @param {number} behavior The desired scroll behavior: either 0 to align with<tr><td><a id="l273"></a><a href="#l273">273</a><td> * the top of the viewport or 1 to align with the bottom.<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @return {!Builder} A self reference.<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>Builder.prototype.setScrollBehavior = function(behavior) {<tr><td><a id="l277"></a><a href="#l277">277</a><td> this.capabilities_.setScrollBehavior(behavior);<tr><td><a id="l278"></a><a href="#l278">278</a><td> return this;<tr><td><a id="l279"></a><a href="#l279">279</a><td>};<tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>/**<tr><td><a id="l283"></a><a href="#l283">283</a><td> * Sets the default action to take with an unexpected alert before returning<tr><td><a id="l284"></a><a href="#l284">284</a><td> * an error.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {string} beahvior The desired behavior; should be &quot;accept&quot;, &quot;dismiss&quot;,<tr><td><a id="l286"></a><a href="#l286">286</a><td> * or &quot;ignore&quot;. Defaults to &quot;dismiss&quot;.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @return {!Builder} A self reference.<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>Builder.prototype.setAlertBehavior = function(behavior) {<tr><td><a id="l290"></a><a href="#l290">290</a><td> this.capabilities_.setAlertBehavior(behavior);<tr><td><a id="l291"></a><a href="#l291">291</a><td> return this;<tr><td><a id="l292"></a><a href="#l292">292</a><td>};<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Sets Chrome specific {@linkplain selenium-webdriver/chrome.Options options}<tr><td><a id="l297"></a><a href="#l297">297</a><td> * for drivers created by this builder. Any logging or proxy settings defined<tr><td><a id="l298"></a><a href="#l298">298</a><td> * on the given options will take precedence over those set through<tr><td><a id="l299"></a><a href="#l299">299</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l300"></a><a href="#l300">300</a><td> *<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @param {!chrome.Options} options The ChromeDriver options to use.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {!Builder} A self reference.<tr><td><a id="l303"></a><a href="#l303">303</a><td> */<tr><td><a id="l304"></a><a href="#l304">304</a><td>Builder.prototype.setChromeOptions = function(options) {<tr><td><a id="l305"></a><a href="#l305">305</a><td> this.chromeOptions_ = options;<tr><td><a id="l306"></a><a href="#l306">306</a><td> return this;<tr><td><a id="l307"></a><a href="#l307">307</a><td>};<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Sets Firefox specific {@linkplain selenium-webdriver/firefox.Options options}<tr><td><a id="l312"></a><a href="#l312">312</a><td> * for drivers created by this builder. Any logging or proxy settings defined<tr><td><a id="l313"></a><a href="#l313">313</a><td> * on the given options will take precedence over those set through<tr><td><a id="l314"></a><a href="#l314">314</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l315"></a><a href="#l315">315</a><td> *<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {!firefox.Options} options The FirefoxDriver options to use.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @return {!Builder} A self reference.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>Builder.prototype.setFirefoxOptions = function(options) {<tr><td><a id="l320"></a><a href="#l320">320</a><td> this.firefoxOptions_ = options;<tr><td><a id="l321"></a><a href="#l321">321</a><td> return this;<tr><td><a id="l322"></a><a href="#l322">322</a><td>};<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>/**<tr><td><a id="l326"></a><a href="#l326">326</a><td> * Sets Opera specific {@linkplain selenium-webdriver/opera.Options options} for<tr><td><a id="l327"></a><a href="#l327">327</a><td> * drivers created by this builder. Any logging or proxy settings defined on the<tr><td><a id="l328"></a><a href="#l328">328</a><td> * given options will take precedence over those set through<tr><td><a id="l329"></a><a href="#l329">329</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l330"></a><a href="#l330">330</a><td> *<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @param {!opera.Options} options The OperaDriver options to use.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @return {!Builder} A self reference.<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>Builder.prototype.setOperaOptions = function(options) {<tr><td><a id="l335"></a><a href="#l335">335</a><td> this.operaOptions_ = options;<tr><td><a id="l336"></a><a href="#l336">336</a><td> return this;<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Sets Internet Explorer specific<tr><td><a id="l342"></a><a href="#l342">342</a><td> * {@linkplain selenium-webdriver/ie.Options options} for drivers created by<tr><td><a id="l343"></a><a href="#l343">343</a><td> * this builder. Any proxy settings defined on the given options will take<tr><td><a id="l344"></a><a href="#l344">344</a><td> * precedence over those set through {@link #setProxy}.<tr><td><a id="l345"></a><a href="#l345">345</a><td> *<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @param {!ie.Options} options The IEDriver options to use.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @return {!Builder} A self reference.<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>Builder.prototype.setIeOptions = function(options) {<tr><td><a id="l350"></a><a href="#l350">350</a><td> this.ieOptions_ = options;<tr><td><a id="l351"></a><a href="#l351">351</a><td> return this;<tr><td><a id="l352"></a><a href="#l352">352</a><td>};<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Sets Safari specific {@linkplain selenium-webdriver/safari.Options options}<tr><td><a id="l357"></a><a href="#l357">357</a><td> * for drivers created by this builder. Any logging settings defined on the<tr><td><a id="l358"></a><a href="#l358">358</a><td> * given options will take precedence over those set through<tr><td><a id="l359"></a><a href="#l359">359</a><td> * {@link #setLoggingPrefs}.<tr><td><a id="l360"></a><a href="#l360">360</a><td> *<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {!safari.Options} options The Safari options to use.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {!Builder} A self reference.<tr><td><a id="l363"></a><a href="#l363">363</a><td> */<tr><td><a id="l364"></a><a href="#l364">364</a><td>Builder.prototype.setSafariOptions = function(options) {<tr><td><a id="l365"></a><a href="#l365">365</a><td> this.safariOptions_ = options;<tr><td><a id="l366"></a><a href="#l366">366</a><td> return this;<tr><td><a id="l367"></a><a href="#l367">367</a><td>};<tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td>/**<tr><td><a id="l371"></a><a href="#l371">371</a><td> * Sets the control flow that created drivers should execute actions in. If<tr><td><a id="l372"></a><a href="#l372">372</a><td> * the flow is never set, or is set to {@code null}, it will use the active<tr><td><a id="l373"></a><a href="#l373">373</a><td> * flow at the time {@link #build()} is called.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {webdriver.promise.ControlFlow} flow The control flow to use, or<tr><td><a id="l375"></a><a href="#l375">375</a><td> * {@code null} to<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @return {!Builder} A self reference.<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>Builder.prototype.setControlFlow = function(flow) {<tr><td><a id="l379"></a><a href="#l379">379</a><td> this.flow_ = flow;<tr><td><a id="l380"></a><a href="#l380">380</a><td> return this;<tr><td><a id="l381"></a><a href="#l381">381</a><td>};<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>/**<tr><td><a id="l385"></a><a href="#l385">385</a><td> * Creates a new WebDriver client based on this builder&#39;s current<tr><td><a id="l386"></a><a href="#l386">386</a><td> * configuration.<tr><td><a id="l387"></a><a href="#l387">387</a><td> *<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {!webdriver.WebDriver} A new WebDriver instance.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @throws {Error} If the current configuration is invalid.<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>Builder.prototype.build = function() {<tr><td><a id="l392"></a><a href="#l392">392</a><td> // Create a copy for any changes we may need to make based on the current<tr><td><a id="l393"></a><a href="#l393">393</a><td> // environment.<tr><td><a id="l394"></a><a href="#l394">394</a><td> var capabilities = new Capabilities(this.capabilities_);<tr><td><a id="l395"></a><a href="#l395">395</a><td><tr><td><a id="l396"></a><a href="#l396">396</a><td> var browser;<tr><td><a id="l397"></a><a href="#l397">397</a><td> if (!this.ignoreEnv_ &amp;&amp; process.env.SELENIUM_BROWSER) {<tr><td><a id="l398"></a><a href="#l398">398</a><td> browser = process.env.SELENIUM_BROWSER.split(/:/, 3);<tr><td><a id="l399"></a><a href="#l399">399</a><td> capabilities.set(Capability.BROWSER_NAME, browser[0]);<tr><td><a id="l400"></a><a href="#l400">400</a><td> capabilities.set(Capability.VERSION, browser[1] || null);<tr><td><a id="l401"></a><a href="#l401">401</a><td> capabilities.set(Capability.PLATFORM, browser[2] || null);<tr><td><a id="l402"></a><a href="#l402">402</a><td> }<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td> browser = capabilities.get(Capability.BROWSER_NAME);<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td> if (typeof browser !== &#39;string&#39;) {<tr><td><a id="l407"></a><a href="#l407">407</a><td> throw TypeError(<tr><td><a id="l408"></a><a href="#l408">408</a><td> &#39;Target browser must be a string, but is &lt;&#39; + (typeof browser) + &#39;&gt;;&#39; +<tr><td><a id="l409"></a><a href="#l409">409</a><td> &#39; did you forget to call forBrowser()?&#39;);<tr><td><a id="l410"></a><a href="#l410">410</a><td> }<tr><td><a id="l411"></a><a href="#l411">411</a><td><tr><td><a id="l412"></a><a href="#l412">412</a><td> if (browser === &#39;ie&#39;) {<tr><td><a id="l413"></a><a href="#l413">413</a><td> browser = Browser.INTERNET_EXPLORER;<tr><td><a id="l414"></a><a href="#l414">414</a><td> }<tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td> // Apply browser specific overrides.<tr><td><a id="l417"></a><a href="#l417">417</a><td> if (browser === Browser.CHROME &amp;&amp; this.chromeOptions_) {<tr><td><a id="l418"></a><a href="#l418">418</a><td> capabilities.merge(this.chromeOptions_.toCapabilities());<tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td> } else if (browser === Browser.FIREFOX &amp;&amp; this.firefoxOptions_) {<tr><td><a id="l421"></a><a href="#l421">421</a><td> capabilities.merge(this.firefoxOptions_.toCapabilities());<tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td> } else if (browser === Browser.INTERNET_EXPLORER &amp;&amp; this.ieOptions_) {<tr><td><a id="l424"></a><a href="#l424">424</a><td> capabilities.merge(this.ieOptions_.toCapabilities());<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td> } else if (browser === Browser.OPERA &amp;&amp; this.operaOptions_) {<tr><td><a id="l427"></a><a href="#l427">427</a><td> capabilities.merge(this.operaOptions_.toCapabilities());<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td> } else if (browser === Browser.SAFARI &amp;&amp; this.safariOptions_) {<tr><td><a id="l430"></a><a href="#l430">430</a><td> capabilities.merge(this.safariOptions_.toCapabilities());<tr><td><a id="l431"></a><a href="#l431">431</a><td> }<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td> // Check for a remote browser.<tr><td><a id="l434"></a><a href="#l434">434</a><td> var url = this.url_;<tr><td><a id="l435"></a><a href="#l435">435</a><td> if (!this.ignoreEnv_) {<tr><td><a id="l436"></a><a href="#l436">436</a><td> if (process.env.SELENIUM_REMOTE_URL) {<tr><td><a id="l437"></a><a href="#l437">437</a><td> url = process.env.SELENIUM_REMOTE_URL;<tr><td><a id="l438"></a><a href="#l438">438</a><td> } else if (process.env.SELENIUM_SERVER_JAR) {<tr><td><a id="l439"></a><a href="#l439">439</a><td> url = startSeleniumServer(process.env.SELENIUM_SERVER_JAR);<tr><td><a id="l440"></a><a href="#l440">440</a><td> }<tr><td><a id="l441"></a><a href="#l441">441</a><td> }<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td> if (url) {<tr><td><a id="l444"></a><a href="#l444">444</a><td> var executor = executors.createExecutor(url, this.proxy_);<tr><td><a id="l445"></a><a href="#l445">445</a><td> return WebDriver.createSession(executor, capabilities, this.flow_);<tr><td><a id="l446"></a><a href="#l446">446</a><td> }<tr><td><a id="l447"></a><a href="#l447">447</a><td><tr><td><a id="l448"></a><a href="#l448">448</a><td> // Check for a native browser.<tr><td><a id="l449"></a><a href="#l449">449</a><td> switch (browser) {<tr><td><a id="l450"></a><a href="#l450">450</a><td> case Browser.CHROME:<tr><td><a id="l451"></a><a href="#l451">451</a><td> // Requiring &#39;chrome&#39; above would create a cycle:<tr><td><a id="l452"></a><a href="#l452">452</a><td> // index -&gt; builder -&gt; chrome -&gt; index<tr><td><a id="l453"></a><a href="#l453">453</a><td> var chrome = require(&#39;./chrome&#39;);<tr><td><a id="l454"></a><a href="#l454">454</a><td> return new chrome.Driver(capabilities, null, this.flow_);<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td> case Browser.FIREFOX:<tr><td><a id="l457"></a><a href="#l457">457</a><td> // Requiring &#39;firefox&#39; above would create a cycle:<tr><td><a id="l458"></a><a href="#l458">458</a><td> // index -&gt; builder -&gt; firefox -&gt; index<tr><td><a id="l459"></a><a href="#l459">459</a><td> var firefox = require(&#39;./firefox&#39;);<tr><td><a id="l460"></a><a href="#l460">460</a><td> return new firefox.Driver(capabilities, this.flow_);<tr><td><a id="l461"></a><a href="#l461">461</a><td><tr><td><a id="l462"></a><a href="#l462">462</a><td> case Browser.INTERNET_EXPLORER:<tr><td><a id="l463"></a><a href="#l463">463</a><td> // Requiring &#39;ie&#39; above would create a cycle:<tr><td><a id="l464"></a><a href="#l464">464</a><td> // index -&gt; builder -&gt; ie -&gt; index<tr><td><a id="l465"></a><a href="#l465">465</a><td> var ie = require(&#39;./ie&#39;);<tr><td><a id="l466"></a><a href="#l466">466</a><td> return new ie.Driver(capabilities, this.flow_);<tr><td><a id="l467"></a><a href="#l467">467</a><td><tr><td><a id="l468"></a><a href="#l468">468</a><td> case Browser.OPERA:<tr><td><a id="l469"></a><a href="#l469">469</a><td> // Requiring &#39;opera&#39; would create a cycle:<tr><td><a id="l470"></a><a href="#l470">470</a><td> // index -&gt; builder -&gt; opera -&gt; index<tr><td><a id="l471"></a><a href="#l471">471</a><td> var opera = require(&#39;./opera&#39;);<tr><td><a id="l472"></a><a href="#l472">472</a><td> return new opera.Driver(capabilities, this.flow_);<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td> case Browser.PHANTOM_JS:<tr><td><a id="l475"></a><a href="#l475">475</a><td> // Requiring &#39;phantomjs&#39; would create a cycle:<tr><td><a id="l476"></a><a href="#l476">476</a><td> // index -&gt; builder -&gt; phantomjs -&gt; index<tr><td><a id="l477"></a><a href="#l477">477</a><td> var phantomjs = require(&#39;./phantomjs&#39;);<tr><td><a id="l478"></a><a href="#l478">478</a><td> return new phantomjs.Driver(capabilities, this.flow_);<tr><td><a id="l479"></a><a href="#l479">479</a><td><tr><td><a id="l480"></a><a href="#l480">480</a><td> case Browser.SAFARI:<tr><td><a id="l481"></a><a href="#l481">481</a><td> // Requiring &#39;safari&#39; would create a cycle:<tr><td><a id="l482"></a><a href="#l482">482</a><td> // index -&gt; builder -&gt; safari -&gt; index<tr><td><a id="l483"></a><a href="#l483">483</a><td> var safari = require(&#39;./safari&#39;);<tr><td><a id="l484"></a><a href="#l484">484</a><td> return new safari.Driver(capabilities, this.flow_);<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td> default:<tr><td><a id="l487"></a><a href="#l487">487</a><td> throw new Error(&#39;Do not know how to build driver: &#39; + browser<tr><td><a id="l488"></a><a href="#l488">488</a><td> + &#39;; did you forget to call usingServer(url)?&#39;);<tr><td><a id="l489"></a><a href="#l489">489</a><td> }<tr><td><a id="l490"></a><a href="#l490">490</a><td>};<tr><td><a id="l491"></a><a href="#l491">491</a><td><tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td>// PUBLIC API<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td>exports.Builder = Builder;</table></div></article><nav><h3><a href="../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../types.js"></script><script src="../dossier.js"></script>