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/Changes.html DELETED
@@ -1,356 +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>Changes</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="indexfile"><h2>v2.48.2</h2>
2
- <ul><li>Added <code>WebElement#takeScreenshot()</code>.</li><li>More adjustments to promise callback tracking.</li></ul>
3
- <h2>v2.48.1</h2>
4
- <ul><li>FIXED: Adjusted how the control flow tracks promise callbacks to avoid a
5
- potential deadlock.</li></ul>
6
- <h2>v2.48.0</h2>
7
- <ul><li>
8
- <p>Node v0.12.x users must run with --harmony. <em>This is the last release that
9
- will support v0.12.x</em></p>
10
- </li><li>
11
- <p>FIXED: (Promise/A&#43; compliance) When a promise is rejected with a thenable,
12
- the promise adopts the thenable as its rejection reason instead of waiting
13
- for it to settle. The previous (incorrect) behavior was hidden by bugs in
14
- the <code>promises-aplus-tests</code> compliance test suite that were fixed in version
15
- <code>2.1.1</code>.</p>
16
- </li><li>
17
- <p>FIXED: the <code>webdriver.promise.ControlFlow</code> now has a consistent execution
18
- order for tasks/callbacks scheduled in different turns of the JS event loop.
19
- Refer to the <code>webdriver.promise</code> documentation for more details.</p>
20
- </li><li>
21
- <p>FIXED: do not drop user auth from the WebDriver server URL.</p>
22
- </li><li>
23
- <p>FIXED: a single <code>firefox.Binary</code> instance may be used to configure and
24
- launch multiple FirefoxDriver sessions.</p>
25
- <pre><code>var binary &#61; new firefox.Binary();
26
- var options &#61; new firefox.Options().setBinary(binary);
27
- var builder &#61; new Builder().setFirefoxOptions(options);
28
-
29
- var driver1 &#61; builder.build();
30
- var driver2 &#61; builder.build();
31
- </code></pre>
32
- </li><li>
33
- <p>FIXED: zip files created for transfer to a remote WebDriver server are no
34
- longer compressed. If the zip contained a file that was already compressed,
35
- the server would return an &#34;invalid code lengths set&#34; error.</p>
36
- </li><li>
37
- <p>FIXED: Surfaced the <code>loopback</code> option to <code>remote/SeleniumServer</code>. When set,
38
- the server will be accessed using the current host&#39;s loopback address.</p>
39
- </li></ul>
40
- <h2>v2.47.0</h2>
41
- <h3>Notice</h3>
42
- <p>This is the last release for <code>selenium-webdriver</code> that will support ES5.
43
- Subsequent releases will depend on ES6 features that are enabled by
44
- <a href="https://nodejs.org/en/docs/es6/">default</a> in Node v4.0.0. Node v0.12.x will
45
- continue to be supported, but will require setting the <code>--harmony</code> flag.</p>
46
- <h3>Change Summary</h3>
47
- <ul><li>Add support for <a href="https://nodejs.org/en/blog/release/v4.0.0/">Node v4.0.0</a>
48
- <ul><li>Updated <code>ws</code> dependency from <code>0.7.1</code> to <code>0.8.0</code></li></ul>
49
- </li><li>Bumped the minimum supported version of Node from <code>0.10.x</code> to <code>0.12.x</code>. This
50
- is in accordance with the Node support policy established in <code>v2.45.0</code>.</li></ul>
51
- <h2>v2.46.1</h2>
52
- <ul><li>Fixed internal module loading on Windows.</li><li>Fixed error message format on timeouts for <code>until.elementLocated()</code>
53
- and <code>until.elementsLocated()</code>.</li></ul>
54
- <h2>v2.46.0</h2>
55
- <ul><li>Exposed a new logging API via the <code>webdriver.logging</code> module. For usage, see
56
- <code>example/logging.js</code>.</li><li>Added support for using a proxy server for WebDriver commands.
57
- See <code>Builder#usingWebDriverProxy()</code> for more info.</li><li>Removed deprecated functions:
58
- <ul><li>Capabilities#toJSON()</li><li>UnhandledAlertError#getAlert()</li><li>chrome.createDriver()</li><li>phantomjs.createDriver()</li><li>promise.ControlFlow#annotateError()</li><li>promise.ControlFlow#await()</li><li>promise.ControlFlow#clearHistory()</li><li>promise.ControlFlow#getHistory()</li></ul>
59
- </li><li>Removed deprecated enum values: <code>ErrorCode.NO_MODAL_DIALOG_OPEN</code> and
60
- <code>ErrorCode.MODAL_DIALOG_OPENED</code>. Use <code>ErrorCode.NO_SUCH_ALERT</code> and
61
- <code>ErrorCode.UNEXPECTED_ALERT_OPEN</code>, respectively.</li><li>FIXED: The <code>promise.ControlFlow</code> will maintain state for promise chains
62
- generated in a loop.</li><li>FIXED: Correct serialize target elements used in an action sequence.</li><li>FIXED: <code>promise.ControlFlow#wait()</code> now has consistent semantics for an
63
- omitted or 0-timeout: it will wait indefinitely.</li><li>FIXED: <code>remote.DriverService#start()</code> will now fail if the child process dies
64
- while waiting for the server to start accepting requests. Previously, start
65
- would continue to poll the server address until the timeout expired.</li><li>FIXED: Skip launching Firefox with the <code>-silent</code> flag to preheat the profile.
66
- Starting with Firefox 38, this would cause the browser to crash. This step,
67
- which was first introduced for Selenium&#39;s java client back with Firefox 2,
68
- no longer appears to be required.</li><li>FIXED: 8564: <code>firefox.Driver#quit()</code> will wait for the Firefox process to
69
- terminate before deleting the temporary webdriver profile. This eliminates a
70
- race condition where Firefox would write profile data during shutdown,
71
- causing the <code>rm -rf</code> operation on the profile directory to fail.</li></ul>
72
- <h2>v2.45.1</h2>
73
- <ul><li>FIXED: 8548: Task callbacks are once again dropped if the task was cancelled
74
- due to a previously uncaught error within the frame.</li><li>FIXED: 8496: Extended the <code>chrome.Options</code> API to cover all configuration
75
- options (e.g. mobile emulation and performance logging) documented on the
76
- ChromeDriver <a href="https://sites.google.com/a/chromium.org/chromedriver/capabilities">project site</a>.</li></ul>
77
- <h2>v2.45.0</h2>
78
- <h3>Important Policy Change</h3>
79
- <p>Starting with the 2.45.0 release, selenium-webdriver will support the last
80
- two stable minor releases for Node. For 2.45.0, this means Selenium will
81
- support Node 0.10.x and 0.12.x. Support for the intermediate, un-stable release
82
- (0.11.x) is &#34;best-effort&#34;. This policy will be re-evaluated once Node has a
83
- major version release (i.e. 1.0.0).</p>
84
- <h3>Change Summary</h3>
85
- <ul><li>
86
- <p>Added native browser support for Internet Explorer, Opera 26&#43;, and Safari</p>
87
- </li><li>
88
- <p>With the release of <a href="http://blog.nodejs.org/2015/02/06/node-v0-12-0-stable/">Node 0.12.0</a>
89
- (finally!), the minimum supported version of Node is now <code>0.10.x</code>.</p>
90
- </li><li>
91
- <p>The <code>promise</code> module is now <a href="https://promisesaplus.com/">Promises/A&#43;</a>
92
- compliant. The biggest compliance change is that promise callbacks are now
93
- invoked in a future turn of the JS event loop. For example:</p>
94
- <pre><code> var promise &#61; require(&#39;selenium-webdriver&#39;).promise;
95
- console.log(&#39;start&#39;);
96
- promise.fulfilled().then(function() {
97
- console.log(&#39;middle&#39;);
98
- });
99
- console.log(&#39;end&#39;);
100
-
101
- // Output in selenium-webdriver&#64;2.44.0
102
- // start
103
- // middle
104
- // end
105
- //
106
- // Output in selenium-webdriver&#64;2.45.0
107
- // start
108
- // end
109
- // middle
110
- </code></pre>
111
- <p>The <code>promise.ControlFlow</code> class has been updated to track the asynchronous
112
- breaks required by Promises/A&#43;, so there are no changes to task execution
113
- order.</p>
114
- </li><li>
115
- <p>Updated how errors are annotated on failures. When a task fails, the
116
- stacktrace from when that task was scheduled is appended to the rejection
117
- reason with a <code>From:</code> prefix (if it is an Error object). For example:</p>
118
- <pre><code> var driver &#61; new webdriver.Builder().forBrowser(&#39;chrome&#39;).build();
119
- driver.get(&#39;http://www.google.com/ncr&#39;);
120
- driver.call(function() {
121
- driver.wait(function() {
122
- return driver.isElementPresent(webdriver.By.id(&#39;not-there&#39;));
123
- }, 2000, &#39;element not found&#39;);
124
- });
125
- </code></pre>
126
- <p>This code will fail an error like:</p>
127
- <pre><code> Error: element not found
128
- Wait timed out after 2002ms
129
- at &lt;stack trace&gt;
130
- From: Task: element not found
131
- at &lt;stack trace&gt;
132
- From: Task: WebDriver.call(function)
133
- at &lt;stack trace&gt;
134
- </code></pre>
135
- </li><li>
136
- <p>Changed the format of strings returned by <code>promise.ControlFlow#getSchedule</code>.
137
- This function now accepts a boolean to control whether the returned string
138
- should include the stacktraces for when each task was scheduled.</p>
139
- </li><li>
140
- <p>Deprecating <code>promise.ControlFlow#getHistory</code>,
141
- <code>promise.ControlFlow#clearHistory</code>, and <code>promise.ControlFlow#annotateError</code>.
142
- These functions were all intended for internal use and are no longer
143
- necessary, so they have been made no-ops.</p>
144
- </li><li>
145
- <p><code>WebDriver.wait()</code> may now be used to wait for a promise to resolve, with
146
- an optional timeout. Refer to the API documentation for more information.</p>
147
- </li><li>
148
- <p>Added support for copying files to a remote Selenium via <code>sendKeys</code> to test
149
- file uploads. Refer to the API documentation for more information. Sample
150
- usage included in <code>test/upload_test.js</code></p>
151
- </li><li>
152
- <p>Expanded the interactions API to include touch actions.
153
- See <code>WebDriver.touchActions()</code>.</p>
154
- </li><li>
155
- <p>FIXED: 8380: <code>firefox.Driver</code> will delete its temporary profile on <code>quit</code>.</p>
156
- </li><li>
157
- <p>FIXED: 8306: Stack overflow in promise callbacks eliminated.</p>
158
- </li><li>
159
- <p>FIXED: 8221: Added support for defining custom command mappings. Includes
160
- support for PhantomJS&#39;s <code>executePhantomJS</code> (requires PhantomJS 1.9.7 or
161
- GhostDriver 1.1.0).</p>
162
- </li><li>
163
- <p>FIXED: 8128: When the FirefoxDriver marshals an object to the page for
164
- <code>executeScript</code>, it defines additional properties (required by the driver&#39;s
165
- implementation). These properties will no longer be enumerable and should
166
- be omitted (i.e. they won&#39;t show up in JSON.stringify output).</p>
167
- </li><li>
168
- <p>FIXED: 8094: The control flow will no longer deadlock when a task returns
169
- a promise that depends on the completion of sub-tasks.</p>
170
- </li></ul>
171
- <h2>v2.44.0</h2>
172
- <ul><li>
173
- <p>Added the <code>until</code> module, which defines common explicit wait conditions.
174
- Sample usage:</p>
175
- <pre><code> var firefox &#61; require(&#39;selenium-webdriver/firefox&#39;),
176
- until &#61; require(&#39;selenium-webdriver/until&#39;);
177
-
178
- var driver &#61; new firefox.Driver();
179
- driver.get(&#39;http://www.google.com/ncr&#39;);
180
- driver.wait(until.titleIs(&#39;Google Search&#39;), 1000);
181
- </code></pre>
182
- </li><li>
183
- <p>FIXED: 8000: <code>Builder.forBrowser()</code> now accepts an empty string since some
184
- WebDriver implementations ignore the value. A value must still be specified,
185
- however, since it is a required field in WebDriver&#39;s wire protocol.</p>
186
- </li><li>
187
- <p>FIXED: 7994: The <code>stacktrace</code> module will not modify stack traces if the
188
- initial parse fails (e.g. the user defined <code>Error.prepareStackTrace</code>)</p>
189
- </li><li>
190
- <p>FIXED: 5855: Added a module (<code>until</code>) that defines several common conditions
191
- for use with explicit waits. See updated examples for usage.</p>
192
- </li></ul>
193
- <h2>v2.43.5</h2>
194
- <ul><li>FIXED: 7905: <code>Builder.usingServer(url)</code> once again returns <code>this</code> for
195
- chaining.</li></ul>
196
- <h2>v2.43.2-4</h2>
197
- <ul><li>No changes; version bumps while attempting to work around an issue with
198
- publishing to npm (a version string may only be used once).</li></ul>
199
- <h2>v2.43.1</h2>
200
- <ul><li>Fixed an issue with flakiness when setting up the Firefox profile that could
201
- prevent the driver from initializing properly.</li></ul>
202
- <h2>v2.43.0</h2>
203
- <ul><li>
204
- <p>Added native support for Firefox - the Java Selenium server is no longer
205
- required.</p>
206
- </li><li>
207
- <p>Added support for generator functions to <code>ControlFlow#execute</code> and
208
- <code>ControlFlow#wait</code>. For more information, see documentation on
209
- <code>webdriver.promise.consume</code>. Requires harmony support (run with
210
- <code>node --harmony-generators</code> in <code>v0.11.x</code>).</p>
211
- </li><li>
212
- <p>Various improvements to the <code>Builder</code> API. Notably, the <code>build()</code> function
213
- will no longer default to attempting to use a server at
214
- <code>http://localhost:4444/wd/hub</code> if it cannot start a browser directly -
215
- you must specify the WebDriver server with <code>usingServer(url)</code>. You can
216
- also set the target browser and WebDriver server through a pair of
217
- environment variables. See the documentation on the <code>Builder</code> constructor
218
- for more information.</p>
219
- </li><li>
220
- <p>For consistency with the other language bindings, added browser specific
221
- classes that can be used to start a browser without the builder.</p>
222
- <pre><code> var webdriver &#61; require(&#39;selenium-webdriver&#39;)
223
- chrome &#61; require(&#39;selenium-webdriver/chrome&#39;);
224
-
225
- // The following are equivalent.
226
- var driver1 &#61; new webdriver.Builder().forBrowser(&#39;chrome&#39;).build();
227
- var driver2 &#61; new chrome.Driver();
228
- </code></pre>
229
- </li><li>
230
- <p>Promise A&#43; compliance: a promise may no longer resolve to itself.</p>
231
- </li><li>
232
- <p>For consistency with other language bindings, deprecated
233
- <code>UnhandledAlertError#getAlert</code> and added <code>#getAlertText</code>.
234
- <code>getAlert</code> will be removed in <code>2.45.0</code>.</p>
235
- </li><li>
236
- <p>FIXED: 7641: Deprecated <code>ErrorCode.NO_MODAL_DIALOG_OPEN</code> and
237
- <code>ErrorCode.MODAL_DIALOG_OPENED</code> in favor of the new
238
- <code>ErrorCode.NO_SUCH_ALERT</code> and <code>ErrorCode.UNEXPECTED_ALERT_OPEN</code>,
239
- respectively.</p>
240
- </li><li>
241
- <p>FIXED: 7563: Mocha integration no longer disables timeouts. Default Mocha
242
- timeouts apply (2000 ms) and may be changed using <code>this.timeout(ms)</code>.</p>
243
- </li><li>
244
- <p>FIXED: 7470: Make it easier to create WebDriver instances in custom flows for
245
- parallel execution.</p>
246
- </li></ul>
247
- <h2>v2.42.1</h2>
248
- <ul><li>FIXED: 7465: Fixed <code>net.getLoopbackAddress</code> on Windows</li><li>FIXED: 7277: Support <code>done</code> callback in Mocha&#39;s BDD interface</li><li>FIXED: 7156: <code>Promise#thenFinally</code> should not suppress original error</li></ul>
249
- <h2>v2.42.0</h2>
250
- <ul><li>Removed deprecated functions <code>Promise#addCallback()</code>,
251
- <code>Promise#addCallbacks()</code>, <code>Promise#addErrback()</code>, and <code>Promise#addBoth()</code>.</li><li>Fail with a more descriptive error if the server returns a malformed redirect</li><li>FIXED: 7300: Connect to ChromeDriver using the loopback address since
252
- ChromeDriver 2.10.267517 binds to localhost by default.</li><li>FIXED: 7339: Preserve wrapped test function&#39;s string representation for
253
- Mocha&#39;s BDD interface.</li></ul>
254
- <h2>v2.41.0</h2>
255
- <ul><li>FIXED: 7138: export logging API from webdriver module.</li><li>FIXED: 7105: beforeEach/it/afterEach properly bind <code>this</code> for Mocha tests.</li></ul>
256
- <h2>v2.40.0</h2>
257
- <ul><li>API documentation is now included in the docs directory.</li><li>Added utility functions for working with an array of promises:
258
- <code>promise.all</code>, <code>promise.map</code>, and <code>promise.filter</code></li><li>Introduced <code>Promise#thenCatch()</code> and <code>Promise#thenFinally()</code>.</li><li>Deprecated <code>Promise#addCallback()</code>, <code>Promise#addCallbacks()</code>,
259
- <code>Promise#addErrback()</code>, and <code>Promise#addBoth()</code>.</li><li>Removed deprecated function <code>webdriver.WebDriver#getCapability</code>.</li><li>FIXED: 6826: Added support for custom locators.</li></ul>
260
- <h2>v2.39.0</h2>
261
- <ul><li>Version bump to stay in sync with the Selenium project.</li></ul>
262
- <h2>v2.38.1</h2>
263
- <ul><li>FIXED: 6686: Changed <code>webdriver.promise.Deferred#cancel()</code> to silently no-op
264
- if the deferred has already been resolved.</li></ul>
265
- <h2>v2.38.0</h2>
266
- <ul><li>When a promise is rejected, always annotate the stacktrace with the parent
267
- flow state so users can identify the source of an error.</li><li>Updated tests to reflect features not working correctly in the SafariDriver
268
- (cookie management and proxy support; see issues 5051, 5212, and 5503)</li><li>FIXED: 6284: For mouse moves, correctly omit the x/y offsets if not
269
- specified as a function argument (instead of passing (0,0)).</li><li>FIXED: 6471: Updated documentation on <code>webdriver.WebElement#getAttribute</code></li><li>FIXED: 6612: On Unix, use the default IANA ephemeral port range if unable to
270
- retrieve the current system&#39;s port range.</li><li>FIXED: 6617: Avoid triggering the node debugger when initializing the
271
- stacktrace module.</li><li>FIXED: 6627: Safely rebuild chrome.Options from a partial JSON spec.</li></ul>
272
- <h2>v2.37.0</h2>
273
- <ul><li>FIXED: 6346: The remote.SeleniumServer class now accepts JVM arguments using
274
- the <code>jvmArgs</code> option.</li></ul>
275
- <h2>v2.36.0</h2>
276
- <ul><li><em>Release skipped to stay in sync with main Selenium project.</em></li></ul>
277
- <h2>v2.35.2</h2>
278
- <ul><li>FIXED: 6200: Pass arguments to the Selenium server instead of to the JVM.</li></ul>
279
- <h2>v2.35.1</h2>
280
- <ul><li>FIXED: 6090: Changed example scripts to use chromedriver.</li></ul>
281
- <h2>v2.35.0</h2>
282
- <ul><li>Version bump to stay in sync with the Selenium project.</li></ul>
283
- <h2>v2.34.1</h2>
284
- <ul><li>FIXED: 6079: The parent process should not wait for spawn driver service
285
- processes (chromedriver, phantomjs, etc.)</li></ul>
286
- <h2>v2.34.0</h2>
287
- <ul><li>
288
- <p>Added the <code>selenium-webdriver/testing/assert</code> module. This module
289
- simplifies writing assertions against promised values (see
290
- example in module documentation).</p>
291
- </li><li>
292
- <p>Added the <code>webdriver.Capabilities</code> class.</p>
293
- </li><li>
294
- <p>Added native support for the ChromeDriver. When using the <code>Builder</code>,
295
- requesting chrome without specifying a remote server URL will default to
296
- the native ChromeDriver implementation. The
297
- <a href="https://code.google.com/p/chromedriver/downloads/list">ChromeDriver server</a>
298
- must be downloaded separately.</p>
299
- <pre><code> // Will start ChromeDriver locally.
300
- var driver &#61; new webdriver.Builder().
301
- withCapabilities(webdriver.Capabilities.chrome()).
302
- build();
303
-
304
- // Will start ChromeDriver using the remote server.
305
- var driver &#61; new webdriver.Builder().
306
- withCapabilities(webdriver.Capabilities.chrome()).
307
- usingServer(&#39;http://server:1234/wd/hub&#39;).
308
- build();
309
- </code></pre>
310
- </li><li>
311
- <p>Added support for configuring proxies through the builder. For examples, see
312
- <code>selenium-webdriver/test/proxy_test</code>.</p>
313
- </li><li>
314
- <p>Added native support for PhantomJS.</p>
315
- </li><li>
316
- <p>Changed signature of <code>SeleniumServer</code> to <code>SeleniumServer(jar, options)</code>.</p>
317
- </li><li>
318
- <p>Tests are now included in the npm published package. See <code>README.md</code> for
319
- execution instructions</p>
320
- </li><li>
321
- <p>Removed the deprecated <code>webdriver.Deferred#resolve</code> and
322
- <code>webdriver.promise.resolved</code> functions.</p>
323
- </li><li>
324
- <p>Removed the ability to connect to an existing session from the Builder. This
325
- feature is intended for use with the browser-based client.</p>
326
- </li></ul>
327
- <h2>v2.33.0</h2>
328
- <ul><li>Added support for WebDriver&#39;s logging API</li><li>FIXED: 5511: Added webdriver.manage().timeouts().pageLoadTimeout(ms)</li></ul>
329
- <h2>v2.32.1</h2>
330
- <ul><li>FIXED: 5541: Added missing return statement for windows in
331
- <code>portprober.findFreePort()</code></li></ul>
332
- <h2>v2.32.0</h2>
333
- <ul><li>Added the <code>selenium-webdriver/testing</code> package, which provides a basic
334
- framework for writing tests using Mocha. See
335
- <code>selenium-webdriver/example/google_search_test.js</code> for usage.</li><li>For Promises/A&#43; compatibility, backing out the change in 2.30.0 that ensured
336
- rejections were always Error objects. Rejection reasons are now left as is.</li><li>Removed deprecated functions originally scheduled for removal in 2.31.0
337
- <ul><li>promise.Application.getInstance()</li><li>promise.ControlFlow#schedule()</li><li>promise.ControlFlow#scheduleTimeout()</li><li>promise.ControlFlow#scheduleWait()</li></ul>
338
- </li><li>Renamed some functions for consistency with Promises/A&#43; terminology. The
339
- original functions have been deprecated and will be removed in 2.34.0:
340
- <ul><li>promise.resolved() -&gt; promise.fulfilled()</li><li>promise.Deferred#resolve() -&gt; promise.Deferred#fulfill()</li></ul>
341
- </li><li>FIXED: remote.SeleniumServer#stop now shuts down within the active control
342
- flow, allowing scripts to finish. Use #kill to shutdown immediately.</li><li>FIXED: 5321: cookie deletion commands</li></ul>
343
- <h2>v2.31.0</h2>
344
- <ul><li>Added an example script.</li><li>Added a class for controlling the standalone Selenium server (server
345
- available separately)</li><li>Added a portprober for finding free ports</li><li>FIXED: WebElements now belong to the same flow as their parent driver.</li></ul>
346
- <h2>v2.30.0</h2>
347
- <ul><li>Ensures promise rejections are always Error values.</li><li>Version bump to keep in sync with the Selenium project.</li></ul>
348
- <h2>v2.29.1</h2>
349
- <ul><li>Fixed a bug that could lead to an infinite loop.</li><li>Added a README.md</li></ul>
350
- <h2>v2.29.0</h2>
351
- <ul><li>
352
- <p>Initial release for npm:</p>
353
- <pre><code> npm install selenium-webdriver
354
- </code></pre>
355
- </li></ul>
356
- </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/class_bot_Error.html DELETED
@@ -1,15 +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>Error</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_bot.html">bot</a></div><div class="codelink"><a href="source/lib/atoms/error.js.src.html#l76">View Source</a></div><h1>class Error</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
2
- &#x2514; bot.Error</pre><p>Represents an error returned from a WebDriver command request.</p>
3
- <h3>new Error(<wbr>code, opt_message)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>code<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The error&#39;s status code.</p>
4
- <dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Optional error message.</p>
5
- </dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/atoms/error.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/String">string</a></code><dd><p>The string representation of this error.</p>
6
- </dl></div></div></div></div><h2>Instance Properties</h2><div id="code" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l82">code</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>This error&#39;s status code.</p>
7
- </dl></div><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
8
- </dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
9
- </dl></div><div id="isAutomationError" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l194">isAutomationError</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
10
- This is required since an Error thrown in one component and then reported
11
- to another will fail instanceof checks in the second component.</p>
12
- </dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
13
- </dl></div><div id="message" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l89">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l104">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
14
- </dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l112">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="state" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l85">state</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Types</h2><dl><dt><a href="enum_bot_Error_State.html">Error.State</a><dd><p>Status strings enumerated in the W3C WebDriver protocol.</p>
15
- </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/class_webdriver_ActionSequence.html DELETED
@@ -1,115 +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>ActionSequence</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.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l45">View Source</a></div><h1>class ActionSequence</h1><p>Class for defining sequences of complex user interactions. Each sequence
2
- will not be executed until <a href="class_webdriver_ActionSequence.html#perform"><code>#perform</code></a> is called.</p>
3
- <p>Example:</p>
4
- <pre><code>new webdriver.ActionSequence(driver).
5
- keyDown(webdriver.Key.SHIFT).
6
- click(element1).
7
- click(element2).
8
- dragAndDrop(element3, element4).
9
- keyUp(webdriver.Key.SHIFT).
10
- perform();
11
- </code></pre>
12
- <h3>new ActionSequence(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver instance to use.</p>
13
- </dl></div></div><h2>Instance Methods</h2><div id="click" class="function"><div><h3>click(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l249">code »</a></span></h3><p>Clicks a mouse button.</p>
14
- <p>If an element is provided, the mouse will first be moved to the center
15
- of that element. This is equivalent to:</p>
16
- <pre><code>sequence.mouseMove(element).click()
17
- </code></pre>
18
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
19
- the element to interact with or the button to click with.
20
- Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
21
- button is specified.</p>
22
- <dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
23
- <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
24
- first argument.</p>
25
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
26
- </dl></div></div></div></div><hr class="fn-sep"><div id="doubleClick" class="function"><div><h3>doubleClick(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l276">code »</a></span></h3><p>Double-clicks a mouse button.</p>
27
- <p>If an element is provided, the mouse will first be moved to the center of
28
- that element. This is equivalent to:</p>
29
- <pre><code>sequence.mouseMove(element).doubleClick()
30
- </code></pre>
31
- <p>Warning: this method currently only supports the left mouse button. See
32
- <a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
33
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
34
- the element to interact with or the button to click with.
35
- Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
36
- button is specified.</p>
37
- <dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
38
- <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
39
- first argument.</p>
40
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
41
- </dl></div></div></div></div><hr class="fn-sep"><div id="dragAndDrop" class="function"><div><h3>dragAndDrop(<wbr>element, location)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l227">code »</a></span></h3><p>Convenience function for performing a &#34;drag and drop&#34; manuever. The target
42
- element may be moved to the location of another element, or by an offset (in
43
- pixels).</p>
44
- <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 drag.</p>
45
- <dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
46
- location to drag to, either as another WebElement or an offset in pixels.</p>
47
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
48
- </dl></div></div></div></div><hr class="fn-sep"><div id="keyDown" class="function"><div><h3>keyDown(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l324">code »</a></span></h3><p>Performs a modifier key press. The modifier key is <em>not released</em>
49
- until <a href="class_webdriver_ActionSequence.html#keyUp"><code>#keyUp</code></a> or <a href="class_webdriver_ActionSequence.html#sendKeys"><code>#sendKeys</code></a> is called. The key press will be
50
- targetted at the currently focused element.</p>
51
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to push. Must be one of
52
- {ALT, CONTROL, SHIFT, COMMAND, META}.</p>
53
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
54
- </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 key is not a valid modifier key.</p>
55
- </dl></div></div></div></div><hr class="fn-sep"><div id="keyUp" class="function"><div><h3>keyUp(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l338">code »</a></span></h3><p>Performs a modifier key release. The release is targetted at the currently
56
- focused element.</p>
57
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to release. Must be one of
58
- {ALT, CONTROL, SHIFT, COMMAND, META}.</p>
59
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
60
- </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 key is not a valid modifier key.</p>
61
- </dl></div></div></div></div><hr class="fn-sep"><div id="mouseDown" class="function"><div><h3>mouseDown(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l183">code »</a></span></h3><p>Presses a mouse button. The mouse button will not be released until
62
- <a href="class_webdriver_ActionSequence.html#mouseUp"><code>#mouseUp</code></a> is called, regardless of whether that call is made in this
63
- sequence or another. The behavior for out-of-order events (e.g. mouseDown,
64
- click) is undefined.</p>
65
- <p>If an element is provided, the mouse will first be moved to the center
66
- of that element. This is equivalent to:</p>
67
- <pre><code>sequence.mouseMove(element).mouseDown()
68
- </code></pre>
69
- <p>Warning: this method currently only supports the left mouse button. See
70
- <a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
71
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
72
- the element to interact with or the button to click with.
73
- Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
74
- button is specified.</p>
75
- <dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
76
- <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
77
- first argument.</p>
78
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
79
- </dl></div></div></div></div><hr class="fn-sep"><div id="mouseMove" class="function"><div><h3>mouseMove(<wbr>location, opt_offset)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l102">code »</a></span></h3><p>Moves the mouse. The location to move to may be specified in terms of the
80
- mouse&#39;s current location, an offset relative to the top-left corner of an
81
- element, or an element (in which case the middle of the element is used).</p>
82
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
83
- location to drag to, as either another WebElement or an offset in pixels.</p>
84
- <dt>opt_offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}=</code><dd><p>If the target <code>location</code>
85
- is defined as a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, this parameter defines an
86
- offset within that element. The offset should be specified in pixels
87
- relative to the top-left corner of the element&#39;s bounding box. If
88
- omitted, the element&#39;s center will be used as the target offset.</p>
89
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
90
- </dl></div></div></div></div><hr class="fn-sep"><div id="mouseUp" class="function"><div><h3>mouseUp(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l211">code »</a></span></h3><p>Releases a mouse button. Behavior is undefined for calling this function
91
- without a previous call to <a href="class_webdriver_ActionSequence.html#mouseDown"><code>#mouseDown</code></a>.</p>
92
- <p>If an element is provided, the mouse will first be moved to the center
93
- of that element. This is equivalent to:</p>
94
- <pre><code>sequence.mouseMove(element).mouseUp()
95
- </code></pre>
96
- <p>Warning: this method currently only supports the left mouse button. See
97
- <a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
98
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
99
- the element to interact with or the button to click with.
100
- Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
101
- button is specified.</p>
102
- <dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
103
- <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
104
- first argument.</p>
105
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
106
- </dl></div></div></div></div><hr class="fn-sep"><div id="perform" class="function"><div><h3>perform()<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l75">code »</a></span></h3><p>Executes this action sequence.</p>
107
- <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 resolved once
108
- this sequence has completed.</p>
109
- </dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l353">code »</a></span></h3><p>Simulates typing multiple keys. Each modifier key encountered in the
110
- sequence will not be released until it is encountered again. All key events
111
- will be targetted at the currently focused element.</p>
112
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<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/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The keys to type.</p>
113
- </dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
114
- </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 key is not a valid modifier key.</p>
115
- </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/class_webdriver_Alert.html DELETED
@@ -1,24 +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>Alert</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.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2302">View Source</a></div><h1>class Alert</h1><p>Represents a modal dialog such as <code>alert</code>, <code>confirm</code>, or
2
- <code>prompt</code>. Provides functions to retrieve the message displayed with
3
- the alert, accept or dismiss the alert, and set the response text (in the
4
- case of <code>prompt</code>).</p>
5
- <h3>new Alert(<wbr>driver, text)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver controlling the browser this
6
- alert is attached to.</p>
7
- <dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The message text displayed with this alert.</p>
8
- </dl></div></div><h2>Instance Methods</h2><div id="accept" class="function"><div><h3>accept()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2327">code »</a></span></h3><p>Accepts this alert.</p>
9
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
10
- when this command has completed.</p>
11
- </dl></div></div></div></div><hr class="fn-sep"><div id="dismiss" class="function"><div><h3>dismiss()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2339">code »</a></span></h3><p>Dismisses this alert.</p>
12
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
13
- when this command has completed.</p>
14
- </dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2317">code »</a></span></h3><p>Retrieves the message text displayed with this alert. For instance, if the
15
- alert were opened with alert(&#34;hello&#34;), then this would return &#34;hello&#34;.</p>
16
- <div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
17
- resolved to the text displayed with this alert.</p>
18
- </dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2354">code »</a></span></h3><p>Sets the response text on this alert. This command will return an error if
19
- the underlying alert does not support response text (e.g. window.alert and
20
- window.confirm).</p>
21
- <div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The text to set.</p>
22
- </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>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
23
- when this command has completed.</p>
24
- </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>