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/source/net/index.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>index.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>net/index.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>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var os = require(&#39;os&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>function getLoInterface() {<tr><td><a id="l24"></a><a href="#l24">24</a><td> var name;<tr><td><a id="l25"></a><a href="#l25">25</a><td> if (process.platform === &#39;darwin&#39;) {<tr><td><a id="l26"></a><a href="#l26">26</a><td> name = &#39;lo0&#39;;<tr><td><a id="l27"></a><a href="#l27">27</a><td> } else if (process.platform === &#39;linux&#39;) {<tr><td><a id="l28"></a><a href="#l28">28</a><td> name = &#39;lo&#39;;<tr><td><a id="l29"></a><a href="#l29">29</a><td> }<tr><td><a id="l30"></a><a href="#l30">30</a><td> return name ? os.networkInterfaces()[name] : null;<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>/**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Queries the system network interfaces for an IP address.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {boolean} loopback Whether to find a loopback address.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {string=} opt_family The IP family (IPv4 or IPv6). Defaults to IPv4.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @return {string} The located IP address or undefined.<tr><td><a id="l39"></a><a href="#l39">39</a><td> */<tr><td><a id="l40"></a><a href="#l40">40</a><td>function getAddress(loopback, opt_family) {<tr><td><a id="l41"></a><a href="#l41">41</a><td> var family = opt_family || &#39;IPv4&#39;;<tr><td><a id="l42"></a><a href="#l42">42</a><td> var addresses = [];<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td> var interfaces;<tr><td><a id="l45"></a><a href="#l45">45</a><td> if (loopback) {<tr><td><a id="l46"></a><a href="#l46">46</a><td> var lo = getLoInterface();<tr><td><a id="l47"></a><a href="#l47">47</a><td> interfaces = lo ? [lo] : null;<tr><td><a id="l48"></a><a href="#l48">48</a><td> }<tr><td><a id="l49"></a><a href="#l49">49</a><td> interfaces = interfaces || os.networkInterfaces();<tr><td><a id="l50"></a><a href="#l50">50</a><td> for (var key in interfaces) {<tr><td><a id="l51"></a><a href="#l51">51</a><td> interfaces[key].forEach(function(ipAddress) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> if (ipAddress.family === family &amp;&amp;<tr><td><a id="l53"></a><a href="#l53">53</a><td> ipAddress.internal === loopback) {<tr><td><a id="l54"></a><a href="#l54">54</a><td> addresses.push(ipAddress.address);<tr><td><a id="l55"></a><a href="#l55">55</a><td> }<tr><td><a id="l56"></a><a href="#l56">56</a><td> });<tr><td><a id="l57"></a><a href="#l57">57</a><td> }<tr><td><a id="l58"></a><a href="#l58">58</a><td> return addresses[0];<tr><td><a id="l59"></a><a href="#l59">59</a><td>}<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td>// PUBLIC API<tr><td><a id="l63"></a><a href="#l63">63</a><td><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> * Retrieves the external IP address for this host.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>exports.getAddress = function(opt_family) {<tr><td><a id="l71"></a><a href="#l71">71</a><td> return getAddress(false, opt_family);<tr><td><a id="l72"></a><a href="#l72">72</a><td>};<tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * Retrieves a loopback address for this machine.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>exports.getLoopbackAddress = function(opt_family) {<tr><td><a id="l81"></a><a href="#l81">81</a><td> return getAddress(true, opt_family);<tr><td><a id="l82"></a><a href="#l82">82</a><td>};</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/net/portprober.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>portprober.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>net/portprober.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>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var exec = require(&#39;child_process&#39;).exec,<tr><td><a id="l21"></a><a href="#l21">21</a><td> fs = require(&#39;fs&#39;),<tr><td><a id="l22"></a><a href="#l22">22</a><td> net = require(&#39;net&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>var promise = require(&#39;../index&#39;).promise;<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * The IANA suggested ephemeral port range.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @type {{min: number, max: number}}<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @const<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @see http://en.wikipedia.org/wiki/Ephemeral_ports<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 DEFAULT_IANA_RANGE = {min: 49152, max: 65535};<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>/**<tr><td><a id="l37"></a><a href="#l37">37</a><td> * The epheremal port range for the current system. Lazily computed on first<tr><td><a id="l38"></a><a href="#l38">38</a><td> * access.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @type {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;}<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>var systemRange = null;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Computes the ephemeral port range for the current system. This is based on<tr><td><a id="l46"></a><a href="#l46">46</a><td> * http://stackoverflow.com/a/924337.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l48"></a><a href="#l48">48</a><td> * that will resolve to the ephemeral port range of the current system.<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>function findSystemPortRange() {<tr><td><a id="l51"></a><a href="#l51">51</a><td> if (systemRange) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> return systemRange;<tr><td><a id="l53"></a><a href="#l53">53</a><td> }<tr><td><a id="l54"></a><a href="#l54">54</a><td> var range = process.platform === &#39;win32&#39; ?<tr><td><a id="l55"></a><a href="#l55">55</a><td> findWindowsPortRange() : findUnixPortRange();<tr><td><a id="l56"></a><a href="#l56">56</a><td> return systemRange = range.thenCatch(function() {<tr><td><a id="l57"></a><a href="#l57">57</a><td> return DEFAULT_IANA_RANGE;<tr><td><a id="l58"></a><a href="#l58">58</a><td> });<tr><td><a id="l59"></a><a href="#l59">59</a><td>}<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td>/**<tr><td><a id="l63"></a><a href="#l63">63</a><td> * Executes a command and returns its output if it succeeds.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {string} cmd The command to execute.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will resolve<tr><td><a id="l66"></a><a href="#l66">66</a><td> * with the command&#39;s stdout data.<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>function execute(cmd) {<tr><td><a id="l69"></a><a href="#l69">69</a><td> var result = promise.defer();<tr><td><a id="l70"></a><a href="#l70">70</a><td> exec(cmd, function(err, stdout) {<tr><td><a id="l71"></a><a href="#l71">71</a><td> if (err) {<tr><td><a id="l72"></a><a href="#l72">72</a><td> result.reject(err);<tr><td><a id="l73"></a><a href="#l73">73</a><td> } else {<tr><td><a id="l74"></a><a href="#l74">74</a><td> result.fulfill(stdout);<tr><td><a id="l75"></a><a href="#l75">75</a><td> }<tr><td><a id="l76"></a><a href="#l76">76</a><td> });<tr><td><a id="l77"></a><a href="#l77">77</a><td> return result.promise;<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><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Computes the ephemeral port range for a Unix-like system.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @return {!webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l84"></a><a href="#l84">84</a><td> * that will resolve with the ephemeral port range on the current system.<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 findUnixPortRange() {<tr><td><a id="l87"></a><a href="#l87">87</a><td> var cmd;<tr><td><a id="l88"></a><a href="#l88">88</a><td> if (process.platform === &#39;sunos&#39;) {<tr><td><a id="l89"></a><a href="#l89">89</a><td> cmd =<tr><td><a id="l90"></a><a href="#l90">90</a><td> &#39;/usr/sbin/ndd /dev/tcp tcp_smallest_anon_port tcp_largest_anon_port&#39;;<tr><td><a id="l91"></a><a href="#l91">91</a><td> } else if (fs.existsSync(&#39;/proc/sys/net/ipv4/ip_local_port_range&#39;)) {<tr><td><a id="l92"></a><a href="#l92">92</a><td> // Linux<tr><td><a id="l93"></a><a href="#l93">93</a><td> cmd = &#39;cat /proc/sys/net/ipv4/ip_local_port_range&#39;;<tr><td><a id="l94"></a><a href="#l94">94</a><td> } else {<tr><td><a id="l95"></a><a href="#l95">95</a><td> cmd = &#39;sysctl net.inet.ip.portrange.first net.inet.ip.portrange.last&#39; +<tr><td><a id="l96"></a><a href="#l96">96</a><td> &#39; | sed -e &quot;s/.*:\\s*//&quot;&#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><tr><td><a id="l99"></a><a href="#l99">99</a><td> return execute(cmd).then(function(stdout) {<tr><td><a id="l100"></a><a href="#l100">100</a><td> if (!stdout || !stdout.length) return DEFAULT_IANA_RANGE;<tr><td><a id="l101"></a><a href="#l101">101</a><td> var range = stdout.trim().split(/\s+/).map(Number);<tr><td><a id="l102"></a><a href="#l102">102</a><td> if (range.some(isNaN)) return DEFAULT_IANA_RANGE;<tr><td><a id="l103"></a><a href="#l103">103</a><td> return {min: range[0], max: range[1]};<tr><td><a id="l104"></a><a href="#l104">104</a><td> });<tr><td><a id="l105"></a><a href="#l105">105</a><td>}<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>/**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * Computes the ephemeral port range for a Windows system.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @return {!webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l111"></a><a href="#l111">111</a><td> * that will resolve with the ephemeral port range on the current system.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>function findWindowsPortRange() {<tr><td><a id="l114"></a><a href="#l114">114</a><td> var deferredRange = promise.defer();<tr><td><a id="l115"></a><a href="#l115">115</a><td> // First, check if we&#39;re running on XP. If this initial command fails,<tr><td><a id="l116"></a><a href="#l116">116</a><td> // we just fallback on the default IANA range.<tr><td><a id="l117"></a><a href="#l117">117</a><td> return execute(&#39;cmd.exe /c ver&#39;).then(function(stdout) {<tr><td><a id="l118"></a><a href="#l118">118</a><td> if (/Windows XP/.test(stdout)) {<tr><td><a id="l119"></a><a href="#l119">119</a><td> // TODO: Try to read these values from the registry.<tr><td><a id="l120"></a><a href="#l120">120</a><td> return {min: 1025, max: 5000};<tr><td><a id="l121"></a><a href="#l121">121</a><td> } else {<tr><td><a id="l122"></a><a href="#l122">122</a><td> return execute(&#39;netsh int ipv4 show dynamicport tcp&#39;).<tr><td><a id="l123"></a><a href="#l123">123</a><td> then(function(stdout) {<tr><td><a id="l124"></a><a href="#l124">124</a><td> /* &gt; netsh int ipv4 show dynamicport tcp<tr><td><a id="l125"></a><a href="#l125">125</a><td> Protocol tcp Dynamic Port Range<tr><td><a id="l126"></a><a href="#l126">126</a><td> ---------------------------------<tr><td><a id="l127"></a><a href="#l127">127</a><td> Start Port : 49152<tr><td><a id="l128"></a><a href="#l128">128</a><td> Number of Ports : 16384<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td> var range = stdout.split(/\n/).filter(function(line) {<tr><td><a id="l131"></a><a href="#l131">131</a><td> return /.*:\s*\d+/.test(line);<tr><td><a id="l132"></a><a href="#l132">132</a><td> }).map(function(line) {<tr><td><a id="l133"></a><a href="#l133">133</a><td> return Number(line.split(/:\s*/)[1]);<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> return {<tr><td><a id="l137"></a><a href="#l137">137</a><td> min: range[0],<tr><td><a id="l138"></a><a href="#l138">138</a><td> max: range[0] + range[1]<tr><td><a id="l139"></a><a href="#l139">139</a><td> };<tr><td><a id="l140"></a><a href="#l140">140</a><td> });<tr><td><a id="l141"></a><a href="#l141">141</a><td> }<tr><td><a id="l142"></a><a href="#l142">142</a><td> });<tr><td><a id="l143"></a><a href="#l143">143</a><td>}<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>/**<tr><td><a id="l147"></a><a href="#l147">147</a><td> * Tests if a port is free.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {number} port The port to test.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Defaults to {@code INADDR_ANY}.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will resolve<tr><td><a id="l152"></a><a href="#l152">152</a><td> * with whether the port is free.<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>function isFree(port, opt_host) {<tr><td><a id="l155"></a><a href="#l155">155</a><td> var result = promise.defer(function() {<tr><td><a id="l156"></a><a href="#l156">156</a><td> server.cancel();<tr><td><a id="l157"></a><a href="#l157">157</a><td> });<tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td> var server = net.createServer().on(&#39;error&#39;, function(e) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> if (e.code === &#39;EADDRINUSE&#39;) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> result.fulfill(false);<tr><td><a id="l162"></a><a href="#l162">162</a><td> } else {<tr><td><a id="l163"></a><a href="#l163">163</a><td> result.reject(e);<tr><td><a id="l164"></a><a href="#l164">164</a><td> }<tr><td><a id="l165"></a><a href="#l165">165</a><td> });<tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td> server.listen(port, opt_host, function() {<tr><td><a id="l168"></a><a href="#l168">168</a><td> server.close(function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td> result.fulfill(true);<tr><td><a id="l170"></a><a href="#l170">170</a><td> });<tr><td><a id="l171"></a><a href="#l171">171</a><td> });<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td> return result.promise;<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>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * Defaults to {@code INADDR_ANY}.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @return {!webdriver.promise.Promise.&lt;number&gt;} A promise that will resolve<tr><td><a id="l181"></a><a href="#l181">181</a><td> * to a free port. If a port cannot be found, the promise will be<tr><td><a id="l182"></a><a href="#l182">182</a><td> * rejected.<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>function findFreePort(opt_host) {<tr><td><a id="l185"></a><a href="#l185">185</a><td> return findSystemPortRange().then(function(range) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> var attempts = 0;<tr><td><a id="l187"></a><a href="#l187">187</a><td> var deferredPort = promise.defer();<tr><td><a id="l188"></a><a href="#l188">188</a><td> findPort();<tr><td><a id="l189"></a><a href="#l189">189</a><td> return deferredPort.promise;<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td> function findPort() {<tr><td><a id="l192"></a><a href="#l192">192</a><td> attempts += 1;<tr><td><a id="l193"></a><a href="#l193">193</a><td> if (attempts &gt; 10) {<tr><td><a id="l194"></a><a href="#l194">194</a><td> deferredPort.reject(Error(&#39;Unable to find a free port&#39;));<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> var port = Math.floor(<tr><td><a id="l198"></a><a href="#l198">198</a><td> Math.random() * (range.max - range.min) + range.min);<tr><td><a id="l199"></a><a href="#l199">199</a><td> isFree(port, opt_host).then(function(isFree) {<tr><td><a id="l200"></a><a href="#l200">200</a><td> if (isFree) {<tr><td><a id="l201"></a><a href="#l201">201</a><td> deferredPort.fulfill(port);<tr><td><a id="l202"></a><a href="#l202">202</a><td> } else {<tr><td><a id="l203"></a><a href="#l203">203</a><td> findPort();<tr><td><a id="l204"></a><a href="#l204">204</a><td> }<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><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>// PUBLIC API<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td>exports.findFreePort = findFreePort;<tr><td><a id="l215"></a><a href="#l215">215</a><td>exports.isFree = isFree;</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/opera.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>opera.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>opera.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 Defines a {@linkplain Driver WebDriver} client for the<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Opera web browser (v26+). Before using this module, you must download the<tr><td><a id="l21"></a><a href="#l21">21</a><td> * latest OperaDriver<tr><td><a id="l22"></a><a href="#l22">22</a><td> * [release](https://github.com/operasoftware/operachromiumdriver/releases) and<tr><td><a id="l23"></a><a href="#l23">23</a><td> * ensure it can be found on your system <tr><td><a id="l24"></a><a href="#l24">24</a><td> * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29).<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * There are three primary classes exported by this module:<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * 1. {@linkplain ServiceBuilder}: configures the<tr><td><a id="l29"></a><a href="#l29">29</a><td> * {@link selenium-webdriver/remote.DriverService remote.DriverService}<tr><td><a id="l30"></a><a href="#l30">30</a><td> * that manages the<tr><td><a id="l31"></a><a href="#l31">31</a><td> * [OperaDriver](https://github.com/operasoftware/operachromiumdriver)<tr><td><a id="l32"></a><a href="#l32">32</a><td> * child process.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * 2. {@linkplain Options}: defines configuration options for each new Opera<tr><td><a id="l35"></a><a href="#l35">35</a><td> * session, such as which {@linkplain Options#setProxy proxy} to use,<tr><td><a id="l36"></a><a href="#l36">36</a><td> * what {@linkplain Options#addExtensions extensions} to install, or<tr><td><a id="l37"></a><a href="#l37">37</a><td> * what {@linkplain Options#addArguments command-line switches} to use when<tr><td><a id="l38"></a><a href="#l38">38</a><td> * starting the browser.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * 3. {@linkplain Driver}: the WebDriver client; each new instance will control<tr><td><a id="l41"></a><a href="#l41">41</a><td> * a unique browser session with a clean user profile (unless otherwise<tr><td><a id="l42"></a><a href="#l42">42</a><td> * configured through the {@link Options} class).<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * By default, every Opera session will use a single driver service, which is<tr><td><a id="l45"></a><a href="#l45">45</a><td> * started the first time a {@link Driver} instance is created and terminated<tr><td><a id="l46"></a><a href="#l46">46</a><td> * when this process exits. The default service will inherit its environment<tr><td><a id="l47"></a><a href="#l47">47</a><td> * from the current process and direct all output to /dev/null. You may obtain<tr><td><a id="l48"></a><a href="#l48">48</a><td> * a handle to this default service using<tr><td><a id="l49"></a><a href="#l49">49</a><td> * {@link #getDefaultService getDefaultService()} and change its configuration<tr><td><a id="l50"></a><a href="#l50">50</a><td> * with {@link #setDefaultService setDefaultService()}.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * You may also create a {@link Driver} with its own driver service. This is<tr><td><a id="l53"></a><a href="#l53">53</a><td> * useful if you need to capture the server&#39;s log output for a specific session:<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * var opera = require(&#39;selenium-webdriver/opera&#39;);<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * var service = new opera.ServiceBuilder()<tr><td><a id="l58"></a><a href="#l58">58</a><td> * .loggingTo(&#39;/my/log/file.txt&#39;)<tr><td><a id="l59"></a><a href="#l59">59</a><td> * .enableVerboseLogging()<tr><td><a id="l60"></a><a href="#l60">60</a><td> * .build();<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * var options = new opera.Options();<tr><td><a id="l63"></a><a href="#l63">63</a><td> * // configure browser options ...<tr><td><a id="l64"></a><a href="#l64">64</a><td> *<tr><td><a id="l65"></a><a href="#l65">65</a><td> * var driver = new opera.Driver(options, service);<tr><td><a id="l66"></a><a href="#l66">66</a><td> *<tr><td><a id="l67"></a><a href="#l67">67</a><td> * Users should only instantiate the {@link Driver} class directly when they<tr><td><a id="l68"></a><a href="#l68">68</a><td> * need a custom driver service configuration (as shown above). For normal<tr><td><a id="l69"></a><a href="#l69">69</a><td> * operation, users should start Opera using the<tr><td><a id="l70"></a><a href="#l70">70</a><td> * {@link selenium-webdriver.Builder}.<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td>&#39;use strict&#39;;<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l76"></a><a href="#l76">76</a><td> util = require(&#39;util&#39;);<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l79"></a><a href="#l79">79</a><td> executors = require(&#39;./executors&#39;),<tr><td><a id="l80"></a><a href="#l80">80</a><td> io = require(&#39;./io&#39;),<tr><td><a id="l81"></a><a href="#l81">81</a><td> portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l82"></a><a href="#l82">82</a><td> remote = require(&#39;./remote&#39;);<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Name of the OperaDriver executable.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @type {string}<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @const<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 OPERADRIVER_EXE =<tr><td><a id="l91"></a><a href="#l91">91</a><td> process.platform === &#39;win32&#39; ? &#39;operadriver.exe&#39; : &#39;operadriver&#39;;<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td>/**<tr><td><a id="l95"></a><a href="#l95">95</a><td> * Creates {@link remote.DriverService} instances that manages an<tr><td><a id="l96"></a><a href="#l96">96</a><td> * [OperaDriver](https://github.com/operasoftware/operachromiumdriver)<tr><td><a id="l97"></a><a href="#l97">97</a><td> * server in a child process.<tr><td><a id="l98"></a><a href="#l98">98</a><td> *<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {string=} opt_exe Path to the server executable to use. If omitted,<tr><td><a id="l100"></a><a href="#l100">100</a><td> * the builder will attempt to locate the operadriver on the current<tr><td><a id="l101"></a><a href="#l101">101</a><td> * PATH.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @throws {Error} If provided executable does not exist, or the operadriver<tr><td><a id="l103"></a><a href="#l103">103</a><td> * cannot be found on the PATH.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @constructor<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>var ServiceBuilder = function(opt_exe) {<tr><td><a id="l107"></a><a href="#l107">107</a><td> /** @private {string} */<tr><td><a id="l108"></a><a href="#l108">108</a><td> this.exe_ = opt_exe || io.findInPath(OPERADRIVER_EXE, true);<tr><td><a id="l109"></a><a href="#l109">109</a><td> if (!this.exe_) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> throw Error(<tr><td><a id="l111"></a><a href="#l111">111</a><td> &#39;The OperaDriver could not be found on the current PATH. Please &#39; +<tr><td><a id="l112"></a><a href="#l112">112</a><td> &#39;download the latest version of the OperaDriver from &#39; +<tr><td><a id="l113"></a><a href="#l113">113</a><td> &#39;https://github.com/operasoftware/operachromiumdriver/releases and &#39; +<tr><td><a id="l114"></a><a href="#l114">114</a><td> &#39;ensure it can be found on your PATH.&#39;);<tr><td><a id="l115"></a><a href="#l115">115</a><td> }<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td> if (!fs.existsSync(this.exe_)) {<tr><td><a id="l118"></a><a href="#l118">118</a><td> throw Error(&#39;File does not exist: &#39; + this.exe_);<tr><td><a id="l119"></a><a href="#l119">119</a><td> }<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td> /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l122"></a><a href="#l122">122</a><td> this.args_ = [];<tr><td><a id="l123"></a><a href="#l123">123</a><td> this.stdio_ = &#39;ignore&#39;;<tr><td><a id="l124"></a><a href="#l124">124</a><td>};<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>/** @private {number} */<tr><td><a id="l128"></a><a href="#l128">128</a><td>ServiceBuilder.prototype.port_ = 0;<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a id="l132"></a><a href="#l132">132</a><td>ServiceBuilder.prototype.stdio_ = &#39;ignore&#39;;<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>/** @private {Object.&lt;string, string&gt;} */<tr><td><a id="l136"></a><a href="#l136">136</a><td>ServiceBuilder.prototype.env_ = null;<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>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Sets the port to start the OperaDriver on.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {number} port The port to use, or 0 for any free port.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @throws {Error} If the port is invalid.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>ServiceBuilder.prototype.usingPort = function(port) {<tr><td><a id="l146"></a><a href="#l146">146</a><td> if (port &lt; 0) {<tr><td><a id="l147"></a><a href="#l147">147</a><td> throw Error(&#39;port must be &gt;= 0: &#39; + port);<tr><td><a id="l148"></a><a href="#l148">148</a><td> }<tr><td><a id="l149"></a><a href="#l149">149</a><td> this.port_ = port;<tr><td><a id="l150"></a><a href="#l150">150</a><td> return this;<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>/**<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Sets the path of the log file the driver should log to. If a log file is<tr><td><a id="l156"></a><a href="#l156">156</a><td> * not specified, the driver will log to stderr.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {string} path Path of the log file to use.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>ServiceBuilder.prototype.loggingTo = function(path) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> this.args_.push(&#39;--log-path=&#39; + path);<tr><td><a id="l162"></a><a href="#l162">162</a><td> return this;<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><tr><td><a id="l166"></a><a href="#l166">166</a><td>/**<tr><td><a id="l167"></a><a href="#l167">167</a><td> * Enables verbose logging.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!ServiceBuilder} 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>ServiceBuilder.prototype.enableVerboseLogging = function() {<tr><td><a id="l171"></a><a href="#l171">171</a><td> this.args_.push(&#39;--verbose&#39;);<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> * Silence sthe drivers output.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>ServiceBuilder.prototype.silent = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td> this.args_.push(&#39;--silent&#39;);<tr><td><a id="l182"></a><a href="#l182">182</a><td> return this;<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>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Defines the stdio configuration for the driver service. See<tr><td><a id="l188"></a><a href="#l188">188</a><td> * {@code child_process.spawn} for more information.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} config The<tr><td><a id="l190"></a><a href="#l190">190</a><td> * configuration to use.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>ServiceBuilder.prototype.setStdio = function(config) {<tr><td><a id="l194"></a><a href="#l194">194</a><td> this.stdio_ = config;<tr><td><a id="l195"></a><a href="#l195">195</a><td> return this;<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>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * Defines the environment to start the server under. This settings will be<tr><td><a id="l201"></a><a href="#l201">201</a><td> * inherited by every browser session started by the server.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {!Object.&lt;string, string&gt;} env The environment to use.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>ServiceBuilder.prototype.withEnvironment = function(env) {<tr><td><a id="l206"></a><a href="#l206">206</a><td> this.env_ = env;<tr><td><a id="l207"></a><a href="#l207">207</a><td> return this;<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Creates a new DriverService using this instance&#39;s current configuration.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @return {remote.DriverService} A new driver service using this instance&#39;s<tr><td><a id="l214"></a><a href="#l214">214</a><td> * current configuration.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @throws {Error} If the driver exectuable was not specified and a default<tr><td><a id="l216"></a><a href="#l216">216</a><td> * could not be found on the current PATH.<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>ServiceBuilder.prototype.build = function() {<tr><td><a id="l219"></a><a href="#l219">219</a><td> var port = this.port_ || portprober.findFreePort();<tr><td><a id="l220"></a><a href="#l220">220</a><td> var args = this.args_.concat(); // Defensive copy.<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td> return new remote.DriverService(this.exe_, {<tr><td><a id="l223"></a><a href="#l223">223</a><td> loopback: true,<tr><td><a id="l224"></a><a href="#l224">224</a><td> port: port,<tr><td><a id="l225"></a><a href="#l225">225</a><td> args: webdriver.promise.when(port, function(port) {<tr><td><a id="l226"></a><a href="#l226">226</a><td> return args.concat(&#39;--port=&#39; + port);<tr><td><a id="l227"></a><a href="#l227">227</a><td> }),<tr><td><a id="l228"></a><a href="#l228">228</a><td> env: this.env_,<tr><td><a id="l229"></a><a href="#l229">229</a><td> stdio: this.stdio_<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>/** @type {remote.DriverService} */<tr><td><a id="l235"></a><a href="#l235">235</a><td>var defaultService = null;<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Sets the default service to use for new OperaDriver instances.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!remote.DriverService} service The service to use.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @throws {Error} If the default service is currently running.<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>function setDefaultService(service) {<tr><td><a id="l244"></a><a href="#l244">244</a><td> if (defaultService &amp;&amp; defaultService.isRunning()) {<tr><td><a id="l245"></a><a href="#l245">245</a><td> throw Error(<tr><td><a id="l246"></a><a href="#l246">246</a><td> &#39;The previously configured OperaDriver service is still running. &#39; +<tr><td><a id="l247"></a><a href="#l247">247</a><td> &#39;You must shut it down before you may adjust its configuration.&#39;);<tr><td><a id="l248"></a><a href="#l248">248</a><td> }<tr><td><a id="l249"></a><a href="#l249">249</a><td> defaultService = service;<tr><td><a id="l250"></a><a href="#l250">250</a><td>}<tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td>/**<tr><td><a id="l254"></a><a href="#l254">254</a><td> * Returns the default OperaDriver service. If such a service has not been<tr><td><a id="l255"></a><a href="#l255">255</a><td> * configured, one will be constructed using the default configuration for<tr><td><a id="l256"></a><a href="#l256">256</a><td> * a OperaDriver executable found on the system PATH.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @return {!remote.DriverService} The default OperaDriver service.<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>function getDefaultService() {<tr><td><a id="l260"></a><a href="#l260">260</a><td> if (!defaultService) {<tr><td><a id="l261"></a><a href="#l261">261</a><td> defaultService = new ServiceBuilder().build();<tr><td><a id="l262"></a><a href="#l262">262</a><td> }<tr><td><a id="l263"></a><a href="#l263">263</a><td> return defaultService;<tr><td><a id="l264"></a><a href="#l264">264</a><td>}<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @type {string}<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @const<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>var OPTIONS_CAPABILITY_KEY = &#39;chromeOptions&#39;;<tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td>/**<tr><td><a id="l275"></a><a href="#l275">275</a><td> * Class for managing {@link Driver OperaDriver} specific options.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @constructor<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @extends {webdriver.Serializable}<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>var Options = function() {<tr><td><a id="l280"></a><a href="#l280">280</a><td> webdriver.Serializable.call(this);<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td> /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l283"></a><a href="#l283">283</a><td> this.args_ = [];<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td> /** @private {!Array.&lt;(string|!Buffer)&gt;} */<tr><td><a id="l286"></a><a href="#l286">286</a><td> this.extensions_ = [];<tr><td><a id="l287"></a><a href="#l287">287</a><td>};<tr><td><a id="l288"></a><a href="#l288">288</a><td>util.inherits(Options, webdriver.Serializable);<tr><td><a id="l289"></a><a href="#l289">289</a><td><tr><td><a id="l290"></a><a href="#l290">290</a><td><tr><td><a id="l291"></a><a href="#l291">291</a><td>/**<tr><td><a id="l292"></a><a href="#l292">292</a><td> * Extracts the OperaDriver specific options from the given capabilities<tr><td><a id="l293"></a><a href="#l293">293</a><td> * object.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @return {!Options} The OperaDriver options.<tr><td><a id="l296"></a><a href="#l296">296</a><td> */<tr><td><a id="l297"></a><a href="#l297">297</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l298"></a><a href="#l298">298</a><td> var options;<tr><td><a id="l299"></a><a href="#l299">299</a><td> var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a id="l300"></a><a href="#l300">300</a><td> if (o instanceof Options) {<tr><td><a id="l301"></a><a href="#l301">301</a><td> options = o;<tr><td><a id="l302"></a><a href="#l302">302</a><td> } else if (o) {<tr><td><a id="l303"></a><a href="#l303">303</a><td> options.<tr><td><a id="l304"></a><a href="#l304">304</a><td> addArguments(o.args || []).<tr><td><a id="l305"></a><a href="#l305">305</a><td> addExtensions(o.extensions || []).<tr><td><a id="l306"></a><a href="#l306">306</a><td> setOperaBinaryPath(o.binary);<tr><td><a id="l307"></a><a href="#l307">307</a><td> } else {<tr><td><a id="l308"></a><a href="#l308">308</a><td> options = new Options;<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> if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a id="l312"></a><a href="#l312">312</a><td> options.setProxy(capabilities.get(webdriver.Capability.PROXY));<tr><td><a id="l313"></a><a href="#l313">313</a><td> }<tr><td><a id="l314"></a><a href="#l314">314</a><td><tr><td><a id="l315"></a><a href="#l315">315</a><td> if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a id="l316"></a><a href="#l316">316</a><td> options.setLoggingPrefs(<tr><td><a id="l317"></a><a href="#l317">317</a><td> capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a id="l318"></a><a href="#l318">318</a><td> }<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td> return options;<tr><td><a id="l321"></a><a href="#l321">321</a><td>};<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> * Add additional command line arguments to use when launching the Opera<tr><td><a id="l326"></a><a href="#l326">326</a><td> * browser. Each argument may be specified with or without the &quot;--&quot; prefix<tr><td><a id="l327"></a><a href="#l327">327</a><td> * (e.g. &quot;--foo&quot; and &quot;foo&quot;). Arguments with an associated value should be<tr><td><a id="l328"></a><a href="#l328">328</a><td> * delimited by an &quot;=&quot;: &quot;foo=bar&quot;.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @return {!Options} A self reference.<tr><td><a id="l331"></a><a href="#l331">331</a><td> */<tr><td><a id="l332"></a><a href="#l332">332</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a id="l333"></a><a href="#l333">333</a><td> this.args_ = this.args_.concat.apply(this.args_, arguments);<tr><td><a id="l334"></a><a href="#l334">334</a><td> return this;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><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> * Add additional extensions to install when launching Opera. Each extension<tr><td><a id="l340"></a><a href="#l340">340</a><td> * should be specified as the path to the packed CRX file, or a Buffer for an<tr><td><a id="l341"></a><a href="#l341">341</a><td> * extension.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {...(string|!Buffer|!Array.&lt;(string|!Buffer)&gt;)} var_args The<tr><td><a id="l343"></a><a href="#l343">343</a><td> * extensions to add.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @return {!Options} A self reference.<tr><td><a id="l345"></a><a href="#l345">345</a><td> */<tr><td><a id="l346"></a><a href="#l346">346</a><td>Options.prototype.addExtensions = function(var_args) {<tr><td><a id="l347"></a><a href="#l347">347</a><td> this.extensions_ = this.extensions_.concat.apply(<tr><td><a id="l348"></a><a href="#l348">348</a><td> this.extensions_, arguments);<tr><td><a id="l349"></a><a href="#l349">349</a><td> return this;<tr><td><a id="l350"></a><a href="#l350">350</a><td>};<tr><td><a id="l351"></a><a href="#l351">351</a><td><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> * Sets the path to the Opera binary to use. On Mac OS X, this path should<tr><td><a id="l355"></a><a href="#l355">355</a><td> * reference the actual Opera executable, not just the application binary. The<tr><td><a id="l356"></a><a href="#l356">356</a><td> * binary path be absolute or relative to the operadriver server executable, but<tr><td><a id="l357"></a><a href="#l357">357</a><td> * it must exist on the machine that will launch Opera.<tr><td><a id="l358"></a><a href="#l358">358</a><td> *<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @param {string} path The path to the Opera binary to use.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @return {!Options} A self reference.<tr><td><a id="l361"></a><a href="#l361">361</a><td> */<tr><td><a id="l362"></a><a href="#l362">362</a><td>Options.prototype.setOperaBinaryPath = function(path) {<tr><td><a id="l363"></a><a href="#l363">363</a><td> this.binary_ = path;<tr><td><a id="l364"></a><a href="#l364">364</a><td> return this;<tr><td><a id="l365"></a><a href="#l365">365</a><td>};<tr><td><a id="l366"></a><a href="#l366">366</a><td><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> * Sets the logging preferences for the new session.<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @return {!Options} A self reference.<tr><td><a id="l372"></a><a href="#l372">372</a><td> */<tr><td><a id="l373"></a><a href="#l373">373</a><td>Options.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l374"></a><a href="#l374">374</a><td> this.logPrefs_ = prefs;<tr><td><a id="l375"></a><a href="#l375">375</a><td> return this;<tr><td><a id="l376"></a><a href="#l376">376</a><td>};<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>/**<tr><td><a id="l380"></a><a href="#l380">380</a><td> * Sets the proxy settings for the new session.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @return {!Options} A self reference.<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l385"></a><a href="#l385">385</a><td> this.proxy_ = proxy;<tr><td><a id="l386"></a><a href="#l386">386</a><td> return this;<tr><td><a id="l387"></a><a href="#l387">387</a><td>};<tr><td><a id="l388"></a><a href="#l388">388</a><td><tr><td><a id="l389"></a><a href="#l389">389</a><td><tr><td><a id="l390"></a><a href="#l390">390</a><td>/**<tr><td><a id="l391"></a><a href="#l391">391</a><td> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l393"></a><a href="#l393">393</a><td> * these options into, if any.<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @return {!webdriver.Capabilities} The 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>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l397"></a><a href="#l397">397</a><td> var capabilities = opt_capabilities || webdriver.Capabilities.opera();<tr><td><a id="l398"></a><a href="#l398">398</a><td> capabilities.<tr><td><a id="l399"></a><a href="#l399">399</a><td> set(webdriver.Capability.PROXY, this.proxy_).<tr><td><a id="l400"></a><a href="#l400">400</a><td> set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).<tr><td><a id="l401"></a><a href="#l401">401</a><td> set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a id="l402"></a><a href="#l402">402</a><td> return capabilities;<tr><td><a id="l403"></a><a href="#l403">403</a><td>};<tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>/**<tr><td><a id="l407"></a><a href="#l407">407</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a id="l408"></a><a href="#l408">408</a><td> * function is an implementation not intended for general use.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @return {{args: !Array.&lt;string&gt;,<tr><td><a id="l410"></a><a href="#l410">410</a><td> * binary: (string|undefined),<tr><td><a id="l411"></a><a href="#l411">411</a><td> * detach: boolean,<tr><td><a id="l412"></a><a href="#l412">412</a><td> * extensions: !Array.&lt;(string|!webdriver.promise.Promise.&lt;string&gt;))&gt;,<tr><td><a id="l413"></a><a href="#l413">413</a><td> * localState: (Object|undefined),<tr><td><a id="l414"></a><a href="#l414">414</a><td> * logPath: (string|undefined),<tr><td><a id="l415"></a><a href="#l415">415</a><td> * prefs: (Object|undefined)}} The JSON wire protocol representation<tr><td><a id="l416"></a><a href="#l416">416</a><td> * of this instance.<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @override<tr><td><a id="l418"></a><a href="#l418">418</a><td> */<tr><td><a id="l419"></a><a href="#l419">419</a><td>Options.prototype.serialize = function() {<tr><td><a id="l420"></a><a href="#l420">420</a><td> var json = {<tr><td><a id="l421"></a><a href="#l421">421</a><td> args: this.args_,<tr><td><a id="l422"></a><a href="#l422">422</a><td> extensions: this.extensions_.map(function(extension) {<tr><td><a id="l423"></a><a href="#l423">423</a><td> if (Buffer.isBuffer(extension)) {<tr><td><a id="l424"></a><a href="#l424">424</a><td> return extension.toString(&#39;base64&#39;);<tr><td><a id="l425"></a><a href="#l425">425</a><td> }<tr><td><a id="l426"></a><a href="#l426">426</a><td> return webdriver.promise.checkedNodeCall(<tr><td><a id="l427"></a><a href="#l427">427</a><td> fs.readFile, extension, &#39;base64&#39;);<tr><td><a id="l428"></a><a href="#l428">428</a><td> })<tr><td><a id="l429"></a><a href="#l429">429</a><td> };<tr><td><a id="l430"></a><a href="#l430">430</a><td> if (this.binary_) {<tr><td><a id="l431"></a><a href="#l431">431</a><td> json.binary = this.binary_;<tr><td><a id="l432"></a><a href="#l432">432</a><td> }<tr><td><a id="l433"></a><a href="#l433">433</a><td> if (this.logFile_) {<tr><td><a id="l434"></a><a href="#l434">434</a><td> json.logPath = this.logFile_;<tr><td><a id="l435"></a><a href="#l435">435</a><td> }<tr><td><a id="l436"></a><a href="#l436">436</a><td> if (this.prefs_) {<tr><td><a id="l437"></a><a href="#l437">437</a><td> json.prefs = this.prefs_;<tr><td><a id="l438"></a><a href="#l438">438</a><td> }<tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td> return json;<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><tr><td><a id="l444"></a><a href="#l444">444</a><td>/**<tr><td><a id="l445"></a><a href="#l445">445</a><td> * Creates a new WebDriver client for Opera.<tr><td><a id="l446"></a><a href="#l446">446</a><td> *<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {(webdriver.Capabilities|Options)=} opt_config The configuration<tr><td><a id="l448"></a><a href="#l448">448</a><td> * options.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @param {remote.DriverService=} opt_service The session to use; will use<tr><td><a id="l450"></a><a href="#l450">450</a><td> * the {@link getDefaultService default service} by default.<tr><td><a id="l451"></a><a href="#l451">451</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l452"></a><a href="#l452">452</a><td> * {@code null} to use the currently active flow.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @constructor<tr><td><a id="l454"></a><a href="#l454">454</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l455"></a><a href="#l455">455</a><td> */<tr><td><a id="l456"></a><a href="#l456">456</a><td>var Driver = function(opt_config, opt_service, opt_flow) {<tr><td><a id="l457"></a><a href="#l457">457</a><td> var service = opt_service || getDefaultService();<tr><td><a id="l458"></a><a href="#l458">458</a><td> var executor = executors.createExecutor(service.start());<tr><td><a id="l459"></a><a href="#l459">459</a><td><tr><td><a id="l460"></a><a href="#l460">460</a><td> var capabilities =<tr><td><a id="l461"></a><a href="#l461">461</a><td> opt_config instanceof Options ? opt_config.toCapabilities() :<tr><td><a id="l462"></a><a href="#l462">462</a><td> (opt_config || webdriver.Capabilities.opera());<tr><td><a id="l463"></a><a href="#l463">463</a><td><tr><td><a id="l464"></a><a href="#l464">464</a><td> // On Linux, the OperaDriver does not look for Opera on the PATH, so we<tr><td><a id="l465"></a><a href="#l465">465</a><td> // must explicitly find it. See: operachromiumdriver #9.<tr><td><a id="l466"></a><a href="#l466">466</a><td> if (process.platform === &#39;linux&#39;) {<tr><td><a id="l467"></a><a href="#l467">467</a><td> var options = Options.fromCapabilities(capabilities);<tr><td><a id="l468"></a><a href="#l468">468</a><td> if (!options.binary_) {<tr><td><a id="l469"></a><a href="#l469">469</a><td> options.setOperaBinaryPath(io.findInPath(&#39;opera&#39;, true));<tr><td><a id="l470"></a><a href="#l470">470</a><td> }<tr><td><a id="l471"></a><a href="#l471">471</a><td> capabilities = options.toCapabilities(capabilities);<tr><td><a id="l472"></a><a href="#l472">472</a><td> }<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td> var driver = webdriver.WebDriver.createSession(<tr><td><a id="l475"></a><a href="#l475">475</a><td> executor, capabilities, opt_flow);<tr><td><a id="l476"></a><a href="#l476">476</a><td><tr><td><a id="l477"></a><a href="#l477">477</a><td> webdriver.WebDriver.call(<tr><td><a id="l478"></a><a href="#l478">478</a><td> this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l479"></a><a href="#l479">479</a><td>};<tr><td><a id="l480"></a><a href="#l480">480</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td>/**<tr><td><a id="l484"></a><a href="#l484">484</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l485"></a><a href="#l485">485</a><td> * implementation.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @override<tr><td><a id="l487"></a><a href="#l487">487</a><td> */<tr><td><a id="l488"></a><a href="#l488">488</a><td>Driver.prototype.setFileDetector = function() {<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>// PUBLIC API<tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td>exports.Driver = Driver;<tr><td><a id="l496"></a><a href="#l496">496</a><td>exports.Options = Options;<tr><td><a id="l497"></a><a href="#l497">497</a><td>exports.ServiceBuilder = ServiceBuilder;<tr><td><a id="l498"></a><a href="#l498">498</a><td>exports.getDefaultService = getDefaultService;<tr><td><a id="l499"></a><a href="#l499">499</a><td>exports.setDefaultService = setDefaultService;</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/phantomjs.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>phantomjs.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>phantomjs.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>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l21"></a><a href="#l21">21</a><td> util = require(&#39;util&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td> executors = require(&#39;./executors&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td> http = require(&#39;./http&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td> io = require(&#39;./io&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td> portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td> remote = require(&#39;./remote&#39;);<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Name of the PhantomJS executable.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @type {string}<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @const<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>var PHANTOMJS_EXE =<tr><td><a id="l37"></a><a href="#l37">37</a><td> process.platform === &#39;win32&#39; ? &#39;phantomjs.exe&#39; : &#39;phantomjs&#39;;<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Capability that designates the location of the PhantomJS executable to use.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {string}<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @const<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>var BINARY_PATH_CAPABILITY = &#39;phantomjs.binary.path&#39;;<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> * Capability that designates the CLI arguments to pass to PhantomJS.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @type {string}<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @const<tr><td><a id="l52"></a><a href="#l52">52</a><td> */<tr><td><a id="l53"></a><a href="#l53">53</a><td>var CLI_ARGS_CAPABILITY = &#39;phantomjs.cli.args&#39;;<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>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * Default log file to use if one is not specified through CLI args.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @type {string}<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @const<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>var DEFAULT_LOG_FILE = &#39;phantomjsdriver.log&#39;;<tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td><tr><td><a id="l64"></a><a href="#l64">64</a><td>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * Custom command names supported by PhantomJS.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @enum {string}<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>var Command = {<tr><td><a id="l69"></a><a href="#l69">69</a><td> EXECUTE_PHANTOM_SCRIPT: &#39;executePhantomScript&#39;<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td>/**<tr><td><a id="l74"></a><a href="#l74">74</a><td> * Finds the PhantomJS executable.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {string=} opt_exe Path to the executable to use.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {string} The located executable.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @throws {Error} If the executable cannot be found on the PATH, or if the<tr><td><a id="l78"></a><a href="#l78">78</a><td> * provided executable path does not exist.<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>function findExecutable(opt_exe) {<tr><td><a id="l81"></a><a href="#l81">81</a><td> var exe = opt_exe || io.findInPath(PHANTOMJS_EXE, true);<tr><td><a id="l82"></a><a href="#l82">82</a><td> if (!exe) {<tr><td><a id="l83"></a><a href="#l83">83</a><td> throw Error(<tr><td><a id="l84"></a><a href="#l84">84</a><td> &#39;The PhantomJS executable could not be found on the current PATH. &#39; +<tr><td><a id="l85"></a><a href="#l85">85</a><td> &#39;Please download the latest version from &#39; +<tr><td><a id="l86"></a><a href="#l86">86</a><td> &#39;http://phantomjs.org/download.html and ensure it can be found on &#39; +<tr><td><a id="l87"></a><a href="#l87">87</a><td> &#39;your PATH. For more information, see &#39; +<tr><td><a id="l88"></a><a href="#l88">88</a><td> &#39;https://github.com/ariya/phantomjs/wiki&#39;);<tr><td><a id="l89"></a><a href="#l89">89</a><td> }<tr><td><a id="l90"></a><a href="#l90">90</a><td> if (!fs.existsSync(exe)) {<tr><td><a id="l91"></a><a href="#l91">91</a><td> throw Error(&#39;File does not exist: &#39; + exe);<tr><td><a id="l92"></a><a href="#l92">92</a><td> }<tr><td><a id="l93"></a><a href="#l93">93</a><td> return exe;<tr><td><a id="l94"></a><a href="#l94">94</a><td>}<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Maps WebDriver logging level name to those recognised by PhantomJS.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @type {!Object.&lt;string, string&gt;}<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @const<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>var WEBDRIVER_TO_PHANTOMJS_LEVEL = (function() {<tr><td><a id="l103"></a><a href="#l103">103</a><td> var map = {};<tr><td><a id="l104"></a><a href="#l104">104</a><td> map[webdriver.logging.Level.ALL.name] = &#39;DEBUG&#39;;<tr><td><a id="l105"></a><a href="#l105">105</a><td> map[webdriver.logging.Level.DEBUG.name] = &#39;DEBUG&#39;;<tr><td><a id="l106"></a><a href="#l106">106</a><td> map[webdriver.logging.Level.INFO.name] = &#39;INFO&#39;;<tr><td><a id="l107"></a><a href="#l107">107</a><td> map[webdriver.logging.Level.WARNING.name] = &#39;WARN&#39;;<tr><td><a id="l108"></a><a href="#l108">108</a><td> map[webdriver.logging.Level.SEVERE.name] = &#39;ERROR&#39;;<tr><td><a id="l109"></a><a href="#l109">109</a><td> return map;<tr><td><a id="l110"></a><a href="#l110">110</a><td>})();<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Creates a command executor with support for PhantomJS&#39; custom commands.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {!webdriver.promise.Promise&lt;string&gt;} url The server&#39;s URL.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>function createExecutor(url) {<tr><td><a id="l119"></a><a href="#l119">119</a><td> return new executors.DeferredExecutor(url.then(function(url) {<tr><td><a id="l120"></a><a href="#l120">120</a><td> var client = new http.HttpClient(url);<tr><td><a id="l121"></a><a href="#l121">121</a><td> var executor = new http.Executor(client);<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td> executor.defineCommand(<tr><td><a id="l124"></a><a href="#l124">124</a><td> Command.EXECUTE_PHANTOM_SCRIPT,<tr><td><a id="l125"></a><a href="#l125">125</a><td> &#39;POST&#39;, &#39;/session/:sessionId/phantom/execute&#39;);<tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td> return executor;<tr><td><a id="l128"></a><a href="#l128">128</a><td> }));<tr><td><a id="l129"></a><a href="#l129">129</a><td>}<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Creates a new WebDriver client for PhantomJS.<tr><td><a id="l133"></a><a href="#l133">133</a><td> *<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {webdriver.Capabilities=} opt_capabilities The desired capabilities.<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l136"></a><a href="#l136">136</a><td> * {@code null} to use the currently active flow.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @constructor<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>var Driver = function(opt_capabilities, opt_flow) {<tr><td><a id="l141"></a><a href="#l141">141</a><td> var capabilities = opt_capabilities || webdriver.Capabilities.phantomjs();<tr><td><a id="l142"></a><a href="#l142">142</a><td> var exe = findExecutable(capabilities.get(BINARY_PATH_CAPABILITY));<tr><td><a id="l143"></a><a href="#l143">143</a><td> var args = [&#39;--webdriver-logfile=&#39; + DEFAULT_LOG_FILE];<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td> var logPrefs = capabilities.get(webdriver.Capability.LOGGING_PREFS);<tr><td><a id="l146"></a><a href="#l146">146</a><td> if (logPrefs instanceof webdriver.logging.Preferences) {<tr><td><a id="l147"></a><a href="#l147">147</a><td> logPrefs = logPrefs.toJSON();<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> if (logPrefs &amp;&amp; logPrefs[webdriver.logging.Type.DRIVER]) {<tr><td><a id="l151"></a><a href="#l151">151</a><td> var level = WEBDRIVER_TO_PHANTOMJS_LEVEL[<tr><td><a id="l152"></a><a href="#l152">152</a><td> logPrefs[webdriver.logging.Type.DRIVER]];<tr><td><a id="l153"></a><a href="#l153">153</a><td> if (level) {<tr><td><a id="l154"></a><a href="#l154">154</a><td> args.push(&#39;--webdriver-loglevel=&#39; + level);<tr><td><a id="l155"></a><a href="#l155">155</a><td> }<tr><td><a id="l156"></a><a href="#l156">156</a><td> }<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td> var proxy = capabilities.get(webdriver.Capability.PROXY);<tr><td><a id="l159"></a><a href="#l159">159</a><td> if (proxy) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> switch (proxy.proxyType) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> case &#39;manual&#39;:<tr><td><a id="l162"></a><a href="#l162">162</a><td> if (proxy.httpProxy) {<tr><td><a id="l163"></a><a href="#l163">163</a><td> args.push(<tr><td><a id="l164"></a><a href="#l164">164</a><td> &#39;--proxy-type=http&#39;,<tr><td><a id="l165"></a><a href="#l165">165</a><td> &#39;--proxy=http://&#39; + proxy.httpProxy);<tr><td><a id="l166"></a><a href="#l166">166</a><td> }<tr><td><a id="l167"></a><a href="#l167">167</a><td> break;<tr><td><a id="l168"></a><a href="#l168">168</a><td> case &#39;pac&#39;:<tr><td><a id="l169"></a><a href="#l169">169</a><td> throw Error(&#39;PhantomJS does not support Proxy PAC files&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td> case &#39;system&#39;:<tr><td><a id="l171"></a><a href="#l171">171</a><td> args.push(&#39;--proxy-type=system&#39;);<tr><td><a id="l172"></a><a href="#l172">172</a><td> break;<tr><td><a id="l173"></a><a href="#l173">173</a><td> case &#39;direct&#39;:<tr><td><a id="l174"></a><a href="#l174">174</a><td> args.push(&#39;--proxy-type=none&#39;);<tr><td><a id="l175"></a><a href="#l175">175</a><td> break;<tr><td><a id="l176"></a><a href="#l176">176</a><td> }<tr><td><a id="l177"></a><a href="#l177">177</a><td> }<tr><td><a id="l178"></a><a href="#l178">178</a><td> args = args.concat(capabilities.get(CLI_ARGS_CAPABILITY) || []);<tr><td><a id="l179"></a><a href="#l179">179</a><td><tr><td><a id="l180"></a><a href="#l180">180</a><td> var port = portprober.findFreePort();<tr><td><a id="l181"></a><a href="#l181">181</a><td> var service = new remote.DriverService(exe, {<tr><td><a id="l182"></a><a href="#l182">182</a><td> port: port,<tr><td><a id="l183"></a><a href="#l183">183</a><td> args: webdriver.promise.when(port, function(port) {<tr><td><a id="l184"></a><a href="#l184">184</a><td> args.push(&#39;--webdriver=&#39; + port);<tr><td><a id="l185"></a><a href="#l185">185</a><td> return args;<tr><td><a id="l186"></a><a href="#l186">186</a><td> })<tr><td><a id="l187"></a><a href="#l187">187</a><td> });<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td> var executor = createExecutor(service.start());<tr><td><a id="l190"></a><a href="#l190">190</a><td> var driver = webdriver.WebDriver.createSession(<tr><td><a id="l191"></a><a href="#l191">191</a><td> executor, capabilities, opt_flow);<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td> webdriver.WebDriver.call(<tr><td><a id="l194"></a><a href="#l194">194</a><td> this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td> var boundQuit = this.quit.bind(this);<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td> /** @override */<tr><td><a id="l199"></a><a href="#l199">199</a><td> this.quit = function() {<tr><td><a id="l200"></a><a href="#l200">200</a><td> return boundQuit().thenFinally(service.kill.bind(service));<tr><td><a id="l201"></a><a href="#l201">201</a><td> };<tr><td><a id="l202"></a><a href="#l202">202</a><td>};<tr><td><a id="l203"></a><a href="#l203">203</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l204"></a><a href="#l204">204</a><td><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> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l208"></a><a href="#l208">208</a><td> * implementation.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @override<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Executes a PhantomJS fragment. This method is similar to<tr><td><a id="l217"></a><a href="#l217">217</a><td> * {@link #executeScript}, except it exposes the<tr><td><a id="l218"></a><a href="#l218">218</a><td> * &lt;a href=&quot;http://phantomjs.org/api/&quot;&gt;PhantomJS API&lt;/a&gt; to the injected<tr><td><a id="l219"></a><a href="#l219">219</a><td> * script.<tr><td><a id="l220"></a><a href="#l220">220</a><td> *<tr><td><a id="l221"></a><a href="#l221">221</a><td> * &lt;p&gt;The injected script will execute in the context of PhantomJS&#39;s<tr><td><a id="l222"></a><a href="#l222">222</a><td> * {@code page} variable. If a page has not been loaded before calling this<tr><td><a id="l223"></a><a href="#l223">223</a><td> * method, one will be created.&lt;/p&gt;<tr><td><a id="l224"></a><a href="#l224">224</a><td> *<tr><td><a id="l225"></a><a href="#l225">225</a><td> * &lt;p&gt;Be sure to wrap callback definitions in a try/catch block, as failures<tr><td><a id="l226"></a><a href="#l226">226</a><td> * may cause future WebDriver calls to fail.&lt;/p&gt;<tr><td><a id="l227"></a><a href="#l227">227</a><td> *<tr><td><a id="l228"></a><a href="#l228">228</a><td> * &lt;p&gt;Certain callbacks are used by GhostDriver (the PhantomJS WebDriver<tr><td><a id="l229"></a><a href="#l229">229</a><td> * implementation) and overriding these may cause the script to fail. It is<tr><td><a id="l230"></a><a href="#l230">230</a><td> * recommended that you check for existing callbacks before defining your own.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * &lt;/p&gt;<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * As with {@link #executeScript}, the injected script may be defined as<tr><td><a id="l234"></a><a href="#l234">234</a><td> * a string for an anonymous function body (e.g. &quot;return 123;&quot;), or as a<tr><td><a id="l235"></a><a href="#l235">235</a><td> * function. If a function is provided, it will be decompiled to its original<tr><td><a id="l236"></a><a href="#l236">236</a><td> * source. Note that injecting functions is provided as a convenience to<tr><td><a id="l237"></a><a href="#l237">237</a><td> * simplify defining complex scripts. Care must be taken that the function<tr><td><a id="l238"></a><a href="#l238">238</a><td> * only references variables that will be defined in the page&#39;s scope and<tr><td><a id="l239"></a><a href="#l239">239</a><td> * that the function does not override {@code Function.prototype.toString}<tr><td><a id="l240"></a><a href="#l240">240</a><td> * (overriding toString() will interfere with how the function is<tr><td><a id="l241"></a><a href="#l241">241</a><td> * decompiled.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {(string|!Function)} script The script to execute.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @return {!webdriver.promise.Promise&lt;T&gt;} A promise that resolve to the<tr><td><a id="l246"></a><a href="#l246">246</a><td> * script&#39;s return value.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @template T<tr><td><a id="l248"></a><a href="#l248">248</a><td> */<tr><td><a id="l249"></a><a href="#l249">249</a><td>Driver.prototype.executePhantomJS = function(script, args) {<tr><td><a id="l250"></a><a href="#l250">250</a><td> if (typeof script === &#39;function&#39;) {<tr><td><a id="l251"></a><a href="#l251">251</a><td> script = &#39;return (&#39; + script + &#39;).apply(this, arguments);&#39;;<tr><td><a id="l252"></a><a href="#l252">252</a><td> }<tr><td><a id="l253"></a><a href="#l253">253</a><td> var args = arguments.length &gt; 1<tr><td><a id="l254"></a><a href="#l254">254</a><td> ? Array.prototype.slice.call(arguments, 1) : [];<tr><td><a id="l255"></a><a href="#l255">255</a><td> return this.schedule(<tr><td><a id="l256"></a><a href="#l256">256</a><td> new webdriver.Command(Command.EXECUTE_PHANTOM_SCRIPT)<tr><td><a id="l257"></a><a href="#l257">257</a><td> .setParameter(&#39;script&#39;, script)<tr><td><a id="l258"></a><a href="#l258">258</a><td> .setParameter(&#39;args&#39;, args),<tr><td><a id="l259"></a><a href="#l259">259</a><td> &#39;Driver.executePhantomJS()&#39;);<tr><td><a id="l260"></a><a href="#l260">260</a><td>};<tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>// PUBLIC API<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td>exports.Driver = Driver;</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/proxy.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>proxy.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>proxy.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 Defines functions for configuring a webdriver proxy:<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * var webdriver = require(&#39;selenium-webdriver&#39;),<tr><td><a id="l22"></a><a href="#l22">22</a><td> * proxy = require(&#39;selenium-webdriver/proxy&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * var driver = new webdriver.Builder()<tr><td><a id="l25"></a><a href="#l25">25</a><td> * .withCapabilities(webdriver.Capabilities.chrome())<tr><td><a id="l26"></a><a href="#l26">26</a><td> * .setProxy(proxy.manual({http: &#39;host:1234&#39;}))<tr><td><a id="l27"></a><a href="#l27">27</a><td> * .build();<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>&#39;use strict&#39;;<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>var util = require(&#39;util&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>// PUBLIC API<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>/**<tr><td><a id="l40"></a><a href="#l40">40</a><td> * Configures WebDriver to bypass all browser proxies.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>exports.direct = function() {<tr><td><a id="l44"></a><a href="#l44">44</a><td> return {proxyType: &#39;direct&#39;};<tr><td><a id="l45"></a><a href="#l45">45</a><td>};<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> * Manually configures the browser proxy. The following options are<tr><td><a id="l50"></a><a href="#l50">50</a><td> * supported:<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * - `ftp`: Proxy host to use for FTP requests<tr><td><a id="l53"></a><a href="#l53">53</a><td> * - `http`: Proxy host to use for HTTP requests<tr><td><a id="l54"></a><a href="#l54">54</a><td> * - `https`: Proxy host to use for HTTPS requests<tr><td><a id="l55"></a><a href="#l55">55</a><td> * - `bypass`: A list of hosts requests should directly connect to,<tr><td><a id="l56"></a><a href="#l56">56</a><td> * bypassing any other proxies for that request. May be specified as a<tr><td><a id="l57"></a><a href="#l57">57</a><td> * comma separated string, or a list of strings.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Behavior is undefined for FTP, HTTP, and HTTPS requests if the<tr><td><a id="l60"></a><a href="#l60">60</a><td> * corresponding key is omitted from the configuration options.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {{ftp: (string|undefined),<tr><td><a id="l63"></a><a href="#l63">63</a><td> * http: (string|undefined),<tr><td><a id="l64"></a><a href="#l64">64</a><td> * https: (string|undefined),<tr><td><a id="l65"></a><a href="#l65">65</a><td> * bypass: (string|!Array.&lt;string&gt;|undefined)}} options Proxy<tr><td><a id="l66"></a><a href="#l66">66</a><td> * configuration options.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>exports.manual = function(options) {<tr><td><a id="l70"></a><a href="#l70">70</a><td> return {<tr><td><a id="l71"></a><a href="#l71">71</a><td> proxyType: &#39;manual&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td> ftpProxy: options.ftp,<tr><td><a id="l73"></a><a href="#l73">73</a><td> httpProxy: options.http,<tr><td><a id="l74"></a><a href="#l74">74</a><td> sslProxy: options.https,<tr><td><a id="l75"></a><a href="#l75">75</a><td> noProxy: util.isArray(options.bypass) ?<tr><td><a id="l76"></a><a href="#l76">76</a><td> options.bypass.join(&#39;,&#39;) : options.bypass<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><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Configures WebDriver to configure the browser proxy using the PAC file at<tr><td><a id="l83"></a><a href="#l83">83</a><td> * the given URL.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {string} url URL for the PAC proxy to use.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>exports.pac = function(url) {<tr><td><a id="l88"></a><a href="#l88">88</a><td> return {<tr><td><a id="l89"></a><a href="#l89">89</a><td> proxyType: &#39;pac&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td> proxyAutoconfigUrl: url<tr><td><a id="l91"></a><a href="#l91">91</a><td> };<tr><td><a id="l92"></a><a href="#l92">92</a><td>};<tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>/**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * Configures WebDriver to use the current system&#39;s proxy.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td>exports.system = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td> return {proxyType: &#39;system&#39;};<tr><td><a id="l101"></a><a href="#l101">101</a><td>};</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>