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
@@ -1,77 +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>Thenable</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="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l837">View Source</a></div><h1>interface Thenable&lt;T&gt;</h1><dl><dt>All extended interfaces<dd><code>IThenable&lt;T&gt;</code></dl><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l891">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
2
- the process. This method is a no-op if the promise has already been
3
- resolved.</p>
4
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
5
- promise is being cancelled.</p>
6
- </dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l894">code »</a></span></h3><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/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
7
- </dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3><code>&lt;R&gt;</code> then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l909">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
8
- <p><b>Specified by: </b><a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
9
- function to call if this promise is successfully resolved. The function
10
- should expect a single argument: the promise&#39;s resolved value.</p>
11
- <dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
12
- expect a single argument: the rejection reason.</p>
13
- </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>A new promise which will be
14
- resolved with the result of the invoked callback.</p>
15
- </dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3><code>&lt;R&gt;</code> thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l934">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
16
- with the <code>catch</code> clause in a synchronous API:</p>
17
- <pre><code>// Synchronous API:
18
- try {
19
- doSynchronousWork();
20
- } catch (ex) {
21
- console.error(ex);
22
- }
23
-
24
- // Asynchronous promise API:
25
- doAsynchronousWork().thenCatch(function(ex) {
26
- console.error(ex);
27
- });
28
- </code></pre>
29
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
30
- function to call if this promise is rejected. The function should
31
- expect a single argument: the rejection reason.</p>
32
- </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>A new promise which will be
33
- resolved with the result of the invoked callback.</p>
34
- </dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3><code>&lt;R&gt;</code> thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l972">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
35
- of whether the promise&#39;s value was successfully computed. This function
36
- is synonymous with the <code>finally</code> clause in a synchronous API:</p>
37
- <pre><code>// Synchronous API:
38
- try {
39
- doSynchronousWork();
40
- } finally {
41
- cleanUp();
42
- }
43
-
44
- // Asynchronous promise API:
45
- doAsynchronousWork().thenFinally(cleanUp);
46
- </code></pre>
47
- <p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
48
- callback returns a rejected promise or throws an error, it will silently
49
- replace the rejection error (if any) from this promise:</p>
50
- <pre><code>try {
51
- throw Error(&#39;one&#39;);
52
- } finally {
53
- throw Error(&#39;two&#39;); // Hides Error: one
54
- }
55
-
56
- promise.rejected(Error(&#39;one&#39;))
57
- .thenFinally(function() {
58
- throw Error(&#39;two&#39;); // Hides Error: one
59
- });
60
- </code></pre>
61
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
62
- to call when this promise is resolved.</p>
63
- </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>A promise that will be fulfilled
64
- with the callback result.</p>
65
- </dl></div></div></div></div><h2>Functions</h2><div id="Thenable.addImplementation" class="function"><div><h3>Thenable.addImplementation(<wbr>ctor)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l847">code »</a></span></h3><p>Adds a property to a class prototype to allow runtime checks of whether
66
- instances of that class implement the Thenable interface. This function
67
- will also ensure the prototype&#39;s <code>then</code> function is exported from
68
- compiled code.</p>
69
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ctor<code>function(new: <a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>, ...?): ?</code><dd><p>The
70
- constructor whose prototype to modify.</p>
71
- </dl></div></div></div></div><hr class="fn-sep"><div id="Thenable.isImplementation" class="function"><div><h3>Thenable.isImplementation(<wbr>object)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l870">code »</a></span></h3><p>Checks if an object has been tagged for implementing the Thenable
72
- interface as defined by
73
- <a href="interface_webdriver_promise_Thenable.html#Thenable.addImplementation"><code>webdriver.promise.Thenable.addImplementation</code></a>.</p>
74
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>object<code>*</code><dd><p>The object to test.</p>
75
- </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/Boolean">boolean</a></code><dd><p>Whether the object is an implementation of the Thenable
76
- interface.</p>
77
- </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>
@@ -1,23 +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>selenium-webdriver</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/index.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver</h1><p>The main user facing module. Exports WebDriver&#39;s primary
2
- public API and provides convenience assessors to certain sub-modules.</p>
3
- <h2>Types</h2><dl><dt><a href="module_selenium-webdriver_class_ActionSequence.html">ActionSequence</a><dd><p>Class for defining sequences of complex user interactions.</p>
4
- <dt><a href="module_selenium-webdriver_enum_Browser.html">Browser</a><dd><p>Recognized browser names.</p>
5
- <dt><a href="module_selenium-webdriver_class_Builder.html">Builder</a><dd><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances.</p>
6
- <dt><a href="module_selenium-webdriver_enum_Button.html">Button</a><dd><p>Enumeration of the buttons used in the advanced interactions API.</p>
7
- <dt><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a><dd><p>No description.</p>
8
- <dt><a href="module_selenium-webdriver_enum_Capability.html">Capability</a><dd><p>Common webdriver capability keys.</p>
9
- <dt><a href="module_selenium-webdriver_class_Command.html">Command</a><dd><p>Describes a command to be executed by the WebDriverJS framework.</p>
10
- <dt><a href="module_selenium-webdriver_enum_CommandName.html">CommandName</a><dd><p>Enumeration of predefined names command names that all command processors
11
- will support.</p>
12
- <dt><a href="module_selenium-webdriver_class_EventEmitter.html">EventEmitter</a><dd><p>Object that can emit events for others to listen for.</p>
13
- <dt><a href="module_selenium-webdriver_class_FileDetector.html">FileDetector</a><dd><p>Used with <a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a> on file
14
- input elements (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>) to detect when the entered key
15
- sequence defines the path to a file.</p>
16
- <dt><a href="module_selenium-webdriver_enum_Key.html">Key</a><dd><p>Representations of pressable keys that aren&#39;t text.</p>
17
- <dt><a href="module_selenium-webdriver_class_Serializable.html">Serializable</a><dd><p>Defines an object that can be asynchronously serialized to its WebDriver
18
- wire representation.</p>
19
- <dt><a href="module_selenium-webdriver_class_Session.html">Session</a><dd><p>Contains information about a WebDriver session.</p>
20
- <dt><a href="module_selenium-webdriver_class_WebDriver.html">WebDriver</a><dd><p>Creates a new WebDriver client, which provides control over a browser.</p>
21
- <dt><a href="module_selenium-webdriver_class_WebElement.html">WebElement</a><dd><p>Represents a DOM element.</p>
22
- <dt><a href="module_selenium-webdriver_class_WebElementPromise.html">WebElementPromise</a><dd><p>WebElementPromise is a promise that will be fulfilled with a WebElement.</p>
23
- </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>
@@ -1,23 +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>selenium-webdriver/_base</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/_base.js.src.html#l31">View Source</a></div><h1>module selenium-webdriver/_base</h1><p>The base module responsible for bootstrapping the Closure
2
- library and providing a means of loading Closure-based modules.</p>
3
- <p>Each script loaded by this module will be granted access to this module&#39;s
4
- <code>require</code> function; all required non-native modules must be specified
5
- relative to <em>this</em> module.
6
- </p><p>This module will load all scripts from the &#34;lib&#34; subdirectory, unless the
7
- SELENIUM_DEV_MODE environment variable has been set to 1, in which case all
8
- scripts will be loaded from the Selenium client containing this script.
9
- </p><h2>Functions</h2><div id="exportPublicApi" class="function"><div><h3>exportPublicApi(<wbr>symbol)<span class="codelink"><a href="source/_base.js.src.html#l178">code »</a></span></h3><p>Loads a symbol by name from the protected Closure context and exports its
10
- public API to the provided object. This function relies on Closure code
11
- conventions to define the public API of an object as those properties whose
12
- name does not end with &#34;_&#34;.</p>
13
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>symbol<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The symbol to load. This must resolve to an object.</p>
14
- </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/Object">Object</a></code><dd><p>An object with the exported API.</p>
15
- </dl></div><div class="fn-details"><div><b>Throws</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>If the symbol has not been defined or does not resolve to
16
- an object.</p>
17
- </dl></div></div></div></div><hr class="fn-sep"><div id="isDevMode" class="function"><div><h3>isDevMode()<span class="codelink"><a href="source/_base.js.src.html#l199">code »</a></span></h3><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/Boolean">boolean</a></code><dd><p>Whether this script was loaded in dev mode.</p>
18
- </dl></div></div></div></div><hr class="fn-sep"><div id="require" class="function"><div><h3>require(<wbr>symbol)<span class="codelink"><a href="source/_base.js.src.html#l200">code »</a></span></h3><p>Loads a symbol by name from the protected Closure context.</p>
19
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>symbol<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The symbol to load.</p>
20
- </dl></div><div class="fn-details"><div><b>Returns</b></div><p>The loaded symbol, or <code>null</code> if not found.</p>
21
- </div><div class="fn-details"><div><b>Throws</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>If the symbol has not been defined.</p>
22
- </dl></div></div></div></div><h2>Properties</h2><div id="closure" class="property"><dl><dt><a href="source/_base.js.src.html#l196">closure</a><code>?</code><dd>No description.</dl></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver__base_class_Context.html">Context</a><dd><p>Maintains a unique context for Closure library-based code.</p>
23
- </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>
@@ -1,5 +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>Context</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="parentlink"><b>Module:</b> <a href="module_selenium-webdriver__base.html">selenium-webdriver/_base</a></div><div class="codelink"><a href="source/_base.js.src.html#l198">View Source</a></div><h1>class Context</h1><p>Maintains a unique context for Closure library-based code.</p>
2
- <h3>new Context(<wbr>opt_configureForTesting)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_configureForTesting<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether to configure a fake DOM
3
- for Closure-testing code that (incorrectly) assumes a DOM is always
4
- present.</p>
5
- </dl></div></div><h2>Instance Properties</h2><div id="closure" class="property"><dl><dt><a href="source/_base.js.src.html#l87">closure</a><code>?</code><dd>No description.</dl></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>
@@ -1,2 +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>selenium-webdriver/builder</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/builder.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/builder</h1><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a><dd><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances.</p>
2
- </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>
@@ -1,138 +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</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="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_builder.html">selenium-webdriver/builder</a></div><div class="codelink"><a href="source/builder.js.src.html#l496">View Source</a></div><h1>class Builder</h1><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances. The environment
2
- variables listed below may be used to override a builder&#39;s configuration,
3
- allowing quick runtime changes.</p>
4
- <ul><li>
5
- <p><code>SELENIUM_BROWSER</code>: defines the target browser in the form
6
- <code>browser[:version][:platform]</code>.</p>
7
- </li><li>
8
- <p><code>SELENIUM_REMOTE_URL</code>: defines the remote URL for all builder
9
- instances. This environment variable should be set to a fully qualified
10
- URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This
11
- option always takes precedence over <code>SELENIUM_SERVER_JAR</code>.</p>
12
- </li><li>
13
- <p><code>SELENIUM_SERVER_JAR</code>: defines the path to the
14
- <a href="http://selenium-release.storage.googleapis.com/index.html">
15
- standalone Selenium server</a> jar to use. The server will be started the
16
- first time a WebDriver instance and be killed when the process exits.</p>
17
- </li></ul>
18
- <p>Suppose you had mytest.js that created WebDriver with</p>
19
- <pre><code>var driver &#61; new webdriver.Builder()
20
- .forBrowser(&#39;chrome&#39;)
21
- .build();
22
- </code></pre>
23
- <p>This test could be made to use Firefox on the local machine by running with
24
- <code>SELENIUM_BROWSER&#61;firefox node mytest.js</code>. Rather than change the code to
25
- target Google Chrome on a remote machine, you can simply set the
26
- <code>SELENIUM_BROWSER</code> and <code>SELENIUM_REMOTE_URL</code> environment variables:</p>
27
- <pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
28
- SELENIUM_REMOTE_URL&#61;http://www.example.com:4444/wd/hub \
29
- node mytest.js
30
- </code></pre>
31
- <p>You could also use a local copy of the standalone Selenium server:</p>
32
- <pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
33
- SELENIUM_SERVER_JAR&#61;/path/to/selenium-server-standalone.jar \
34
- node mytest.js
35
- </code></pre>
36
- <h3>new Builder()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="build" class="function"><div><h3>build()<span class="codelink"><a href="source/builder.js.src.html#l391">code »</a></span></h3><p>Creates a new WebDriver client based on this builder&#39;s current
37
- configuration.</p>
38
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>A new WebDriver instance.</p>
39
- </dl></div><div class="fn-details"><div><b>Throws</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>If the current configuration is invalid.</p>
40
- </dl></div></div></div></div><hr class="fn-sep"><div id="disableEnvironmentOverrides" class="function"><div><h3>disableEnvironmentOverrides()<span class="codelink"><a href="source/builder.js.src.html#l130">code »</a></span></h3><p>Configures this builder to ignore any environment variable overrides and to
41
- only use the configuration specified through this instance&#39;s API.</p>
42
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
43
- </dl></div></div></div></div><hr class="fn-sep"><div id="forBrowser" class="function"><div><h3>forBrowser(<wbr>name, opt_version, opt_platform)<span class="codelink"><a href="source/builder.js.src.html#l225">code »</a></span></h3><p>Configures the target browser for clients created by this instance.
44
- Any calls to <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
45
- overwrite these settings.</p>
46
- <p>You may also define the target browser using the <code>SELENIUM_BROWSER</code>
47
- environment variable. If set, this environment variable should be of the
48
- form <code>browser[:[version][:platform]]</code>.</p>
49
- <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 name of the target browser;
50
- common defaults are available on the <a href="enum_webdriver_Browser.html"><code>webdriver.Browser</code></a> enum.</p>
51
- <dt>opt_version<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A desired version; may be omitted if any
52
- version should be used.</p>
53
- <dt>opt_platform<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The desired platform; may be omitted if any
54
- version may be used.</p>
55
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
56
- </dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/builder.js.src.html#l203">code »</a></span></h3><p>Returns the base set of capabilities this instance is currently configured
57
- to use.</p>
58
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The current capabilities for this builder.</p>
59
- </dl></div></div></div></div><hr class="fn-sep"><div id="getServerUrl" class="function"><div><h3>getServerUrl()<span class="codelink"><a href="source/builder.js.src.html#l157">code »</a></span></h3><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 URL of the WebDriver server this instance is configured
60
- to use.</p>
61
- </dl></div></div></div></div><hr class="fn-sep"><div id="getWebDriverProxy" class="function"><div><h3>getWebDriverProxy()<span class="codelink"><a href="source/builder.js.src.html#l180">code »</a></span></h3><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 URL of the proxy server to use for the WebDriver&#39;s HTTP
62
- connections.</p>
63
- </dl></div></div></div></div><hr class="fn-sep"><div id="setAlertBehavior" class="function"><div><h3>setAlertBehavior(<wbr>beahvior)<span class="codelink"><a href="source/builder.js.src.html#l289">code »</a></span></h3><p>Sets the default action to take with an unexpected alert before returning
64
- an error.</p>
65
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>beahvior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired behavior; should be &#34;accept&#34;, &#34;dismiss&#34;,
66
- or &#34;ignore&#34;. Defaults to &#34;dismiss&#34;.</p>
67
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
68
- </dl></div></div></div></div><hr class="fn-sep"><div id="setChromeOptions" class="function"><div><h3>setChromeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l304">code »</a></span></h3><p>Sets Chrome specific <a href="module_selenium-webdriver_chrome_class_Options.html">options</a>
69
- for drivers created by this builder. Any logging or proxy settings defined
70
- on the given options will take precedence over those set through
71
- <a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
72
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>chrome.Options</code><dd><p>The ChromeDriver options to use.</p>
73
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
74
- </dl></div></div></div></div><hr class="fn-sep"><div id="setControlFlow" class="function"><div><h3>setControlFlow(<wbr>flow)<span class="codelink"><a href="source/builder.js.src.html#l378">code »</a></span></h3><p>Sets the control flow that created drivers should execute actions in. If
75
- the flow is never set, or is set to <code>null</code>, it will use the active
76
- flow at the time <a href="module_selenium-webdriver_builder_class_Builder.html#build"><code>#build()</code></a> is called.</p>
77
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>flow<code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow to use, or
78
- <code>null</code> to</p>
79
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
80
- </dl></div></div></div></div><hr class="fn-sep"><div id="setEnableNativeEvents" class="function"><div><h3>setEnableNativeEvents(<wbr>enabled)<span class="codelink"><a href="source/builder.js.src.html#l264">code »</a></span></h3><p>Sets whether native events should be used.</p>
81
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable native events.</p>
82
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
83
- </dl></div></div></div></div><hr class="fn-sep"><div id="setFirefoxOptions" class="function"><div><h3>setFirefoxOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l319">code »</a></span></h3><p>Sets Firefox specific <a href="module_selenium-webdriver_firefox_class_Options.html">options</a>
84
- for drivers created by this builder. Any logging or proxy settings defined
85
- on the given options will take precedence over those set through
86
- <a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
87
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>firefox.Options</code><dd><p>The FirefoxDriver options to use.</p>
88
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
89
- </dl></div></div></div></div><hr class="fn-sep"><div id="setIeOptions" class="function"><div><h3>setIeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l349">code »</a></span></h3><p>Sets Internet Explorer specific
90
- <a href="module_selenium-webdriver_ie_class_Options.html">options</a> for drivers created by
91
- this builder. Any proxy settings defined on the given options will take
92
- precedence over those set through <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>.</p>
93
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>ie.Options</code><dd><p>The IEDriver options to use.</p>
94
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
95
- </dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/builder.js.src.html#l253">code »</a></span></h3><p>Sets the logging preferences for the created session. Preferences may be
96
- changed by repeated calls, or by calling <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a>.</p>
97
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The
98
- desired logging preferences.</p>
99
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
100
- </dl></div></div></div></div><hr class="fn-sep"><div id="setOperaOptions" class="function"><div><h3>setOperaOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l334">code »</a></span></h3><p>Sets Opera specific <a href="module_selenium-webdriver_opera_class_Options.html">options</a> for
101
- drivers created by this builder. Any logging or proxy settings defined on the
102
- given options will take precedence over those set through
103
- <a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
104
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>opera.Options</code><dd><p>The OperaDriver options to use.</p>
105
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
106
- </dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>config)<span class="codelink"><a href="source/builder.js.src.html#l240">code »</a></span></h3><p>Sets the proxy configuration to use for WebDriver clients created by this
107
- builder. Any calls to <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
108
- overwrite these settings.</p>
109
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The configuration to use.</p>
110
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
111
- </dl></div></div></div></div><hr class="fn-sep"><div id="setSafariOptions" class="function"><div><h3>setSafariOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l364">code »</a></span></h3><p>Sets Safari specific <a href="module_selenium-webdriver_safari_class_Options.html">options</a>
112
- for drivers created by this builder. Any logging settings defined on the
113
- given options will take precedence over those set through
114
- <a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a>.</p>
115
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>safari.Options</code><dd><p>The Safari options to use.</p>
116
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
117
- </dl></div></div></div></div><hr class="fn-sep"><div id="setScrollBehavior" class="function"><div><h3>setScrollBehavior(<wbr>behavior)<span class="codelink"><a href="source/builder.js.src.html#l276">code »</a></span></h3><p>Sets how elements should be scrolled into view for interaction.</p>
118
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired scroll behavior: either 0 to align with
119
- the top of the viewport or 1 to align with the bottom.</p>
120
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
121
- </dl></div></div></div></div><hr class="fn-sep"><div id="usingServer" class="function"><div><h3>usingServer(<wbr>url)<span class="codelink"><a href="source/builder.js.src.html#l147">code »</a></span></h3><p>Sets the URL of a remote WebDriver server to use. Once a remote URL has been
122
- specified, the builder direct all new clients to that server. If this method
123
- is never called, the Builder will attempt to create all clients locally.</p>
124
- <p>As an alternative to this method, you may also set the <code>SELENIUM_REMOTE_URL</code>
125
- environment variable.</p>
126
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a remote server to use.</p>
127
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
128
- </dl></div></div></div></div><hr class="fn-sep"><div id="usingWebDriverProxy" class="function"><div><h3>usingWebDriverProxy(<wbr>proxy)<span class="codelink"><a href="source/builder.js.src.html#l170">code »</a></span></h3><p>Sets the URL of the proxy to use for the WebDriver&#39;s HTTP connections.
129
- If this method is never called, the Builder will create a connection without
130
- a proxy.</p>
131
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a proxy to use.</p>
132
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
133
- </dl></div></div></div></div><hr class="fn-sep"><div id="withCapabilities" class="function"><div><h3>withCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/builder.js.src.html#l192">code »</a></span></h3><p>Sets the desired capabilities when requesting a new session. This will
134
- overwrite any previously set capabilities.</p>
135
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The desired
136
- capabilities for a new session.</p>
137
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
138
- </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>
@@ -1,90 +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>selenium-webdriver/chrome</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/chrome.js.src.html#l115">View Source</a></div><h1>module selenium-webdriver/chrome</h1><p>Defines a <a href="module_selenium-webdriver_chrome_class_Driver.html">WebDriver</a> client for the Chrome
2
- web browser. Before using this module, you must download the latest
3
- <a href="http://chromedriver.storage.googleapis.com/index.html">ChromeDriver release</a> and ensure it can be found on your system <a href="http://en.wikipedia.org/wiki/PATH_%28variable%29">PATH</a>.</p>
4
- <p>There are three primary classes exported by this module:</p>
5
- <ol><li>
6
- <p><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a>: configures the
7
- <a href="module_selenium-webdriver_remote_class_DriverService.html"><code>remote.DriverService</code></a>
8
- that manages the <a href="https://sites.google.com/a/chromium.org/chromedriver/">ChromeDriver</a> child process.</p>
9
- </li><li>
10
- <p><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a>: defines configuration options for each new Chrome
11
- session, such as which <a href="module_selenium-webdriver_chrome_class_Options.html#setProxy">proxy</a> to use,
12
- what <a href="module_selenium-webdriver_chrome_class_Options.html#addExtensions">extensions</a> to install, or
13
- what <a href="module_selenium-webdriver_chrome_class_Options.html#addArguments">command-line switches</a> to use when
14
- starting the browser.</p>
15
- </li><li>
16
- <p><a href="module_selenium-webdriver_chrome_class_Driver.html">Driver</a>: the WebDriver client; each new instance will control
17
- a unique browser session with a clean user profile (unless otherwise
18
- configured through the <a href="module_selenium-webdriver_chrome_class_Options.html"><code>Options</code></a> class).</p>
19
- </li></ol>
20
- <p><strong>Customizing the ChromeDriver Server</strong> <a id="custom-server"></a></p>
21
- <p>By default, every Chrome session will use a single driver service, which is
22
- started the first time a <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> instance is created and terminated
23
- when this process exits. The default service will inherit its environment
24
- from the current process and direct all output to /dev/null. You may obtain
25
- a handle to this default service using
26
- <a href="module_selenium-webdriver_chrome.html#getDefaultService"><code>getDefaultService()</code></a> and change its configuration
27
- with <a href="module_selenium-webdriver_chrome.html#setDefaultService"><code>setDefaultService()</code></a>.</p>
28
- <p>You may also create a <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> with its own driver service. This is
29
- useful if you need to capture the server&#39;s log output for a specific session:</p>
30
- <pre><code>var chrome &#61; require(&#39;selenium-webdriver/chrome&#39;);
31
-
32
- var service &#61; new chrome.ServiceBuilder()
33
- .loggingTo(&#39;/my/log/file.txt&#39;)
34
- .enableVerboseLogging()
35
- .build();
36
-
37
- var options &#61; new chrome.Options();
38
- // configure browser options ...
39
-
40
- var driver &#61; new chrome.Driver(options, service);
41
- </code></pre>
42
- <p>Users should only instantiate the <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> class directly when they
43
- need a custom driver service configuration (as shown above). For normal
44
- operation, users should start Chrome using the
45
- <a href="module_selenium-webdriver_class_Builder.html"><code>selenium-webdriver.Builder</code></a>.</p>
46
- <p><strong>Working with Android</strong> <a id="android"></a></p>
47
- <p>The <a href="https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android">ChromeDriver</a> supports running tests on the Chrome browser as
48
- well as <a href="https://developer.chrome.com/multidevice/webview/overview">WebView apps</a> starting in Android 4.4 (KitKat). In order to
49
- work with Android, you must first start the adb</p>
50
- <pre><code>adb start-server
51
- </code></pre>
52
- <p>By default, adb will start on port 5037. You may change this port, but this
53
- will require configuring a <a href="#custom-server">custom server</a> that will connect
54
- to adb on the <a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html#setAdbPort">correct port</a>:</p>
55
- <pre><code>var service &#61; new chrome.ServiceBuilder()
56
- .setAdbPort(1234)
57
- build();
58
- // etc.
59
- </code></pre>
60
- <p>The ChromeDriver may be configured to launch Chrome on Android using
61
- <a href="module_selenium-webdriver_chrome_class_Options.html#androidChrome"><code>Options#androidChrome()</code></a>:</p>
62
- <pre><code>var driver &#61; new Builder()
63
- .forBrowser(&#39;chrome&#39;)
64
- .setChromeOptions(new chrome.Options().androidChrome())
65
- .build();
66
- </code></pre>
67
- <p>Alternatively, you can configure the ChromeDriver to launch an app with a
68
- Chrome-WebView by setting the <a href="module_selenium-webdriver_chrome_class_Options.html#androidActivity">androidActivity</a> option:</p>
69
- <pre><code>var driver &#61; new Builder()
70
- .forBrowser(&#39;chrome&#39;)
71
- .setChromeOptions(new chrome.Options()
72
- .androidPackage(&#39;com.example&#39;)
73
- .androidActivity(&#39;com.example.Activity&#39;))
74
- .build();
75
- </code></pre>
76
- <p>[Refer to the ChromeDriver site] for more information on using the
77
- <a href="https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android">ChromeDriver with Android</a>.</p>
78
- <h2>Functions</h2><div id="getDefaultService" class="function"><div><h3>getDefaultService()<span class="codelink"><a href="source/chrome.js.src.html#l847">code »</a></span></h3><p>Returns the default ChromeDriver service. If such a service has not been
79
- configured, one will be constructed using the default configuration for
80
- a ChromeDriver executable found on the system PATH.</p>
81
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The default ChromeDriver service.</p>
82
- </dl></div></div></div></div><hr class="fn-sep"><div id="setDefaultService" class="function"><div><h3>setDefaultService(<wbr>service)<span class="codelink"><a href="source/chrome.js.src.html#l848">code »</a></span></h3><p>Sets the default service to use for new ChromeDriver instances.</p>
83
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>service<code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The service to use.</p>
84
- </dl></div><div class="fn-details"><div><b>Throws</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>If the default service is currently running.</p>
85
- </dl></div></div></div></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_chrome_class_Driver.html">Driver</a><dd><p>Creates a new WebDriver client for Chrome.</p>
86
- <dt><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a><dd><p>Class for managing ChromeDriver specific options.</p>
87
- <dt><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a><dd><p>Creates <a href="module_selenium-webdriver_remote_class_DriverService.html"><code>selenium-webdriver/remote.DriverService</code></a> instances that manage
88
- a <a href="https://sites.google.com/a/chromium.org/chromedriver/">ChromeDriver</a>
89
- server in a child process.</p>
90
- </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>