selenium-webdriver 2.47.0 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/CHANGES.md +96 -0
  2. package/NOTICE +1 -1
  3. package/README.md +57 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +80 -114
  12. package/firefox/extension.js +10 -19
  13. package/firefox/index.js +175 -171
  14. package/firefox/profile.js +221 -239
  15. package/http/index.js +396 -77
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +89 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +6 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/promise.js +3093 -0
  34. package/lib/safari/client.js +697 -659
  35. package/lib/session.js +79 -0
  36. package/{test/promise_aplus_test.js → lib/symbols.js} +15 -25
  37. package/lib/test/build.js +4 -4
  38. package/lib/test/data/click_tests/disappearing_element.html +62 -0
  39. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  40. package/lib/test/data/click_tests/overlapping_elements.html +70 -0
  41. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  42. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  43. package/lib/test/data/readOnlyPage.html +3 -1
  44. package/lib/test/data/selectPage.html +18 -2
  45. package/lib/test/data/simpleTest.html +1 -0
  46. package/lib/test/fileserver.js +3 -4
  47. package/lib/test/index.js +13 -4
  48. package/lib/test/resources.js +1 -1
  49. package/lib/until.js +428 -0
  50. package/lib/webdriver.js +2351 -0
  51. package/net/portprober.js +15 -11
  52. package/opera.js +295 -314
  53. package/package.json +6 -5
  54. package/phantomjs.js +135 -140
  55. package/proxy.js +6 -4
  56. package/remote/index.js +234 -219
  57. package/safari.js +319 -310
  58. package/test/chrome/options_test.js +11 -9
  59. package/test/element_finding_test.js +51 -13
  60. package/test/error_test.js +163 -0
  61. package/test/execute_script_test.js +1 -1
  62. package/test/firefox/firefox_test.js +24 -0
  63. package/test/http/http_test.js +354 -43
  64. package/test/http/util_test.js +25 -23
  65. package/test/io_test.js +6 -1
  66. package/test/lib/by_test.js +127 -0
  67. package/test/lib/capabilities_test.js +84 -0
  68. package/test/lib/events_test.js +177 -0
  69. package/test/lib/logging_test.js +272 -0
  70. package/test/lib/promise_aplus_test.js +74 -0
  71. package/test/lib/promise_error_test.js +808 -0
  72. package/test/lib/promise_flow_test.js +2282 -0
  73. package/test/lib/promise_generator_test.js +308 -0
  74. package/test/lib/promise_test.js +996 -0
  75. package/test/lib/testutil.js +90 -0
  76. package/test/lib/until_test.js +436 -0
  77. package/test/lib/webdriver_test.js +2207 -0
  78. package/test/page_loading_test.js +7 -9
  79. package/test/stale_element_test.js +2 -2
  80. package/test/testing/assert_test.js +374 -0
  81. package/test/testing/index_test.js +9 -11
  82. package/testing/assert.js +334 -17
  83. package/testing/index.js +10 -0
  84. package/_base.js +0 -200
  85. package/docs/Changes.html +0 -317
  86. package/docs/class_bot_Error.html +0 -15
  87. package/docs/class_webdriver_ActionSequence.html +0 -115
  88. package/docs/class_webdriver_Alert.html +0 -24
  89. package/docs/class_webdriver_AlertPromise.html +0 -91
  90. package/docs/class_webdriver_Capabilities.html +0 -60
  91. package/docs/class_webdriver_Command.html +0 -15
  92. package/docs/class_webdriver_EventEmitter.html +0 -35
  93. package/docs/class_webdriver_FileDetector.html +0 -21
  94. package/docs/class_webdriver_Locator.html +0 -12
  95. package/docs/class_webdriver_Serializable.html +0 -9
  96. package/docs/class_webdriver_Session.html +0 -13
  97. package/docs/class_webdriver_TouchSequence.html +0 -49
  98. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  99. package/docs/class_webdriver_WebDriver.html +0 -313
  100. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  101. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  102. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  103. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  104. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  105. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  106. package/docs/class_webdriver_WebElement.html +0 -216
  107. package/docs/class_webdriver_WebElementPromise.html +0 -266
  108. package/docs/class_webdriver_http_Executor.html +0 -22
  109. package/docs/class_webdriver_http_Request.html +0 -12
  110. package/docs/class_webdriver_http_Response.html +0 -13
  111. package/docs/class_webdriver_logging_Entry.html +0 -15
  112. package/docs/class_webdriver_logging_Level.html +0 -55
  113. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  114. package/docs/class_webdriver_logging_Logger.html +0 -119
  115. package/docs/class_webdriver_logging_Preferences.html +0 -8
  116. package/docs/class_webdriver_promise_CancellationError.html +0 -18
  117. package/docs/class_webdriver_promise_ControlFlow.html +0 -109
  118. package/docs/class_webdriver_promise_Deferred.html +0 -84
  119. package/docs/class_webdriver_promise_Promise.html +0 -74
  120. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  121. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  122. package/docs/class_webdriver_testing_Assertion.html +0 -99
  123. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  124. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  125. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  126. package/docs/class_webdriver_until_Condition.html +0 -7
  127. package/docs/dossier.css +0 -1
  128. package/docs/dossier.js +0 -86
  129. package/docs/enum_bot_ErrorCode.html +0 -3
  130. package/docs/enum_bot_Error_State.html +0 -2
  131. package/docs/enum_webdriver_Browser.html +0 -2
  132. package/docs/enum_webdriver_Button.html +0 -2
  133. package/docs/enum_webdriver_Capability.html +0 -33
  134. package/docs/enum_webdriver_CommandName.html +0 -3
  135. package/docs/enum_webdriver_Key.html +0 -12
  136. package/docs/enum_webdriver_logging_Type.html +0 -6
  137. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  138. package/docs/index.html +0 -123
  139. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  140. package/docs/interface_webdriver_http_Client.html +0 -10
  141. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  142. package/docs/module_selenium-webdriver.html +0 -23
  143. package/docs/module_selenium-webdriver__base.html +0 -23
  144. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  145. package/docs/module_selenium-webdriver_builder.html +0 -2
  146. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  147. package/docs/module_selenium-webdriver_chrome.html +0 -90
  148. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  149. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  150. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  151. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  152. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  153. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  154. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  155. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  156. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  157. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  158. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  159. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  160. package/docs/module_selenium-webdriver_class_WebElement.html +0 -216
  161. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -266
  162. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  163. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  164. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  165. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  166. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  167. package/docs/module_selenium-webdriver_error.html +0 -4
  168. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  169. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  170. package/docs/module_selenium-webdriver_executors.html +0 -10
  171. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  172. package/docs/module_selenium-webdriver_firefox.html +0 -67
  173. package/docs/module_selenium-webdriver_firefox_binary.html +0 -4
  174. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -21
  175. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -21
  176. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  177. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  178. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  180. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  181. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  182. package/docs/module_selenium-webdriver_http.html +0 -9
  183. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  184. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  185. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  186. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  187. package/docs/module_selenium-webdriver_http_util.html +0 -17
  188. package/docs/module_selenium-webdriver_ie.html +0 -11
  189. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  190. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  191. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  192. package/docs/module_selenium-webdriver_io.html +0 -37
  193. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  194. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  195. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  196. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  197. package/docs/module_selenium-webdriver_namespace_promise.html +0 -162
  198. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  199. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  200. package/docs/module_selenium-webdriver_net.html +0 -7
  201. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  202. package/docs/module_selenium-webdriver_opera.html +0 -62
  203. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  204. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  205. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  206. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  207. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  208. package/docs/module_selenium-webdriver_proxy.html +0 -28
  209. package/docs/module_selenium-webdriver_remote.html +0 -8
  210. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  211. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  212. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -40
  213. package/docs/module_selenium-webdriver_safari.html +0 -9
  214. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  215. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  216. package/docs/module_selenium-webdriver_testing.html +0 -74
  217. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  218. package/docs/namespace_bot.html +0 -4
  219. package/docs/namespace_bot_json.html +0 -20
  220. package/docs/namespace_bot_response.html +0 -18
  221. package/docs/namespace_bot_userAgent.html +0 -33
  222. package/docs/namespace_webdriver.html +0 -30
  223. package/docs/namespace_webdriver_By.html +0 -56
  224. package/docs/namespace_webdriver_http.html +0 -6
  225. package/docs/namespace_webdriver_logging.html +0 -70
  226. package/docs/namespace_webdriver_promise.html +0 -165
  227. package/docs/namespace_webdriver_stacktrace.html +0 -17
  228. package/docs/namespace_webdriver_testing.html +0 -7
  229. package/docs/namespace_webdriver_testing_assert.html +0 -9
  230. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  231. package/docs/namespace_webdriver_until.html +0 -82
  232. package/docs/source/_base.js.src.html +0 -1
  233. package/docs/source/builder.js.src.html +0 -1
  234. package/docs/source/chrome.js.src.html +0 -1
  235. package/docs/source/error.js.src.html +0 -1
  236. package/docs/source/executors.js.src.html +0 -1
  237. package/docs/source/firefox/binary.js.src.html +0 -1
  238. package/docs/source/firefox/extension.js.src.html +0 -1
  239. package/docs/source/firefox/index.js.src.html +0 -1
  240. package/docs/source/firefox/profile.js.src.html +0 -1
  241. package/docs/source/http/index.js.src.html +0 -1
  242. package/docs/source/http/util.js.src.html +0 -1
  243. package/docs/source/ie.js.src.html +0 -1
  244. package/docs/source/index.js.src.html +0 -1
  245. package/docs/source/io/exec.js.src.html +0 -1
  246. package/docs/source/io/index.js.src.html +0 -1
  247. package/docs/source/lib/atoms/error.js.src.html +0 -1
  248. package/docs/source/lib/atoms/json.js.src.html +0 -1
  249. package/docs/source/lib/atoms/response.js.src.html +0 -1
  250. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  251. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  252. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  254. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  255. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  256. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  257. package/docs/source/lib/goog/base.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  261. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  262. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  263. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  264. package/docs/source/lib/goog/deps.js.src.html +0 -1
  265. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  266. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  271. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  272. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  273. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  285. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  286. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  291. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  292. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  293. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  294. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  295. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  296. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  310. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  311. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  314. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  315. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  316. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  318. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  319. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  320. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  322. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  323. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  326. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  327. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  328. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/watchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  348. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  349. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  350. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  351. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  369. package/docs/source/net/index.js.src.html +0 -1
  370. package/docs/source/net/portprober.js.src.html +0 -1
  371. package/docs/source/opera.js.src.html +0 -1
  372. package/docs/source/phantomjs.js.src.html +0 -1
  373. package/docs/source/proxy.js.src.html +0 -1
  374. package/docs/source/remote/index.js.src.html +0 -1
  375. package/docs/source/safari.js.src.html +0 -1
  376. package/docs/source/testing/assert.js.src.html +0 -1
  377. package/docs/source/testing/index.js.src.html +0 -1
  378. package/docs/types.js +0 -1
  379. package/lib/atoms/error.js +0 -202
  380. package/lib/atoms/json.js +0 -80
  381. package/lib/atoms/response.js +0 -110
  382. package/lib/atoms/userAgent.js +0 -257
  383. package/lib/goog/LICENSE +0 -176
  384. package/lib/goog/array/array.js +0 -1655
  385. package/lib/goog/asserts/asserts.js +0 -365
  386. package/lib/goog/async/freelist.js +0 -88
  387. package/lib/goog/async/nexttick.js +0 -241
  388. package/lib/goog/async/run.js +0 -139
  389. package/lib/goog/async/workqueue.js +0 -139
  390. package/lib/goog/base.js +0 -2547
  391. package/lib/goog/debug/debug.js +0 -653
  392. package/lib/goog/debug/entrypointregistry.js +0 -158
  393. package/lib/goog/debug/error.js +0 -63
  394. package/lib/goog/debug/logbuffer.js +0 -148
  395. package/lib/goog/debug/logger.js +0 -873
  396. package/lib/goog/debug/logrecord.js +0 -242
  397. package/lib/goog/deps.js +0 -151
  398. package/lib/goog/disposable/disposable.js +0 -307
  399. package/lib/goog/disposable/idisposable.js +0 -45
  400. package/lib/goog/dom/browserfeature.js +0 -72
  401. package/lib/goog/dom/dom.js +0 -2995
  402. package/lib/goog/dom/nodetype.js +0 -48
  403. package/lib/goog/dom/safe.js +0 -347
  404. package/lib/goog/dom/tagname.js +0 -160
  405. package/lib/goog/dom/tags.js +0 -42
  406. package/lib/goog/dom/vendor.js +0 -96
  407. package/lib/goog/events/browserevent.js +0 -386
  408. package/lib/goog/events/browserfeature.js +0 -85
  409. package/lib/goog/events/event.js +0 -143
  410. package/lib/goog/events/eventid.js +0 -47
  411. package/lib/goog/events/events.js +0 -984
  412. package/lib/goog/events/eventtarget.js +0 -394
  413. package/lib/goog/events/eventtype.js +0 -233
  414. package/lib/goog/events/keycodes.js +0 -420
  415. package/lib/goog/events/listenable.js +0 -335
  416. package/lib/goog/events/listener.js +0 -131
  417. package/lib/goog/events/listenermap.js +0 -308
  418. package/lib/goog/fs/url.js +0 -105
  419. package/lib/goog/functions/functions.js +0 -332
  420. package/lib/goog/html/safehtml.js +0 -756
  421. package/lib/goog/html/safescript.js +0 -234
  422. package/lib/goog/html/safestyle.js +0 -442
  423. package/lib/goog/html/safestylesheet.js +0 -276
  424. package/lib/goog/html/safeurl.js +0 -431
  425. package/lib/goog/html/trustedresourceurl.js +0 -224
  426. package/lib/goog/html/uncheckedconversions.js +0 -231
  427. package/lib/goog/i18n/bidi.js +0 -908
  428. package/lib/goog/iter/iter.js +0 -1305
  429. package/lib/goog/json/json.js +0 -365
  430. package/lib/goog/labs/testing/assertthat.js +0 -58
  431. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  432. package/lib/goog/labs/testing/matcher.js +0 -80
  433. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  434. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  435. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  436. package/lib/goog/labs/useragent/browser.js +0 -327
  437. package/lib/goog/labs/useragent/engine.js +0 -160
  438. package/lib/goog/labs/useragent/platform.js +0 -160
  439. package/lib/goog/labs/useragent/util.js +0 -148
  440. package/lib/goog/math/box.js +0 -389
  441. package/lib/goog/math/coordinate.js +0 -268
  442. package/lib/goog/math/math.js +0 -451
  443. package/lib/goog/math/rect.js +0 -476
  444. package/lib/goog/math/size.js +0 -227
  445. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  446. package/lib/goog/net/xhrlike.js +0 -124
  447. package/lib/goog/net/xmlhttp.js +0 -246
  448. package/lib/goog/net/xmlhttpfactory.js +0 -67
  449. package/lib/goog/object/object.js +0 -686
  450. package/lib/goog/promise/promise.js +0 -1310
  451. package/lib/goog/promise/resolver.js +0 -48
  452. package/lib/goog/promise/thenable.js +0 -126
  453. package/lib/goog/reflect/reflect.js +0 -78
  454. package/lib/goog/string/const.js +0 -182
  455. package/lib/goog/string/string.js +0 -1565
  456. package/lib/goog/string/typedstring.js +0 -48
  457. package/lib/goog/structs/collection.js +0 -56
  458. package/lib/goog/structs/map.js +0 -456
  459. package/lib/goog/structs/set.js +0 -279
  460. package/lib/goog/structs/structs.js +0 -354
  461. package/lib/goog/style/style.js +0 -2054
  462. package/lib/goog/testing/asserts.js +0 -1265
  463. package/lib/goog/testing/events/events.js +0 -727
  464. package/lib/goog/testing/functionmock.js +0 -176
  465. package/lib/goog/testing/jsunit.js +0 -162
  466. package/lib/goog/testing/loosemock.js +0 -242
  467. package/lib/goog/testing/mock.js +0 -645
  468. package/lib/goog/testing/mockclock.js +0 -617
  469. package/lib/goog/testing/mockcontrol.js +0 -220
  470. package/lib/goog/testing/mockinterface.js +0 -45
  471. package/lib/goog/testing/mockmatchers.js +0 -400
  472. package/lib/goog/testing/objectpropertystring.js +0 -68
  473. package/lib/goog/testing/propertyreplacer.js +0 -245
  474. package/lib/goog/testing/recordfunction.js +0 -215
  475. package/lib/goog/testing/stacktrace.js +0 -594
  476. package/lib/goog/testing/strictmock.js +0 -130
  477. package/lib/goog/testing/testcase.js +0 -1569
  478. package/lib/goog/testing/testrunner.js +0 -440
  479. package/lib/goog/testing/watchers.js +0 -46
  480. package/lib/goog/uri/uri.js +0 -1507
  481. package/lib/goog/uri/utils.js +0 -1116
  482. package/lib/goog/useragent/product.js +0 -175
  483. package/lib/goog/useragent/product_isversion.js +0 -143
  484. package/lib/goog/useragent/useragent.js +0 -538
  485. package/lib/webdriver/actionsequence.js +0 -356
  486. package/lib/webdriver/builder.js +0 -208
  487. package/lib/webdriver/capabilities.js +0 -411
  488. package/lib/webdriver/events.js +0 -179
  489. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  490. package/lib/webdriver/http/corsclient.js +0 -133
  491. package/lib/webdriver/http/http.js +0 -523
  492. package/lib/webdriver/http/xhrclient.js +0 -67
  493. package/lib/webdriver/locators.js +0 -257
  494. package/lib/webdriver/logging.js +0 -347
  495. package/lib/webdriver/promise.js +0 -2609
  496. package/lib/webdriver/serializable.js +0 -41
  497. package/lib/webdriver/session.js +0 -74
  498. package/lib/webdriver/stacktrace.js +0 -619
  499. package/lib/webdriver/test/builder_test.js +0 -53
  500. package/lib/webdriver/test/capabilities_test.js +0 -72
  501. package/lib/webdriver/test/events_test.js +0 -203
  502. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  503. package/lib/webdriver/test/http/http_test.js +0 -428
  504. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  505. package/lib/webdriver/test/locators_test.js +0 -59
  506. package/lib/webdriver/test/logging_test.js +0 -85
  507. package/lib/webdriver/test/promise_error_test.js +0 -719
  508. package/lib/webdriver/test/promise_flow_test.js +0 -1957
  509. package/lib/webdriver/test/promise_generator_test.js +0 -251
  510. package/lib/webdriver/test/promise_test.js +0 -1981
  511. package/lib/webdriver/test/stacktrace_test.js +0 -480
  512. package/lib/webdriver/test/test_bootstrap.js +0 -67
  513. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  514. package/lib/webdriver/test/testing/client_test.js +0 -88
  515. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  516. package/lib/webdriver/test/testutil.js +0 -209
  517. package/lib/webdriver/test/testutil_test.js +0 -104
  518. package/lib/webdriver/test/until_test.js +0 -411
  519. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  520. package/lib/webdriver/test/webdriver_test.js +0 -2369
  521. package/lib/webdriver/testing/asserts.js +0 -487
  522. package/lib/webdriver/testing/client.js +0 -179
  523. package/lib/webdriver/testing/jsunit.js +0 -363
  524. package/lib/webdriver/testing/testcase.js +0 -168
  525. package/lib/webdriver/testing/window.js +0 -244
  526. package/lib/webdriver/touchsequence.js +0 -248
  527. package/lib/webdriver/until.js +0 -412
  528. package/lib/webdriver/webdriver.js +0 -2492
  529. 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>