selenium-webdriver 2.48.2 → 2.53.3

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