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/chrome.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>chrome.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>chrome.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 Chrome<tr><td><a id="l20"></a><a href="#l20">20</a><td> * web browser. Before using this module, you must download the latest<tr><td><a id="l21"></a><a href="#l21">21</a><td> * [ChromeDriver release] and ensure it can be found on your system [PATH].<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * There are three primary classes exported by this module:<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * 1. {@linkplain ServiceBuilder}: configures the<tr><td><a id="l26"></a><a href="#l26">26</a><td> * {@link selenium-webdriver/remote.DriverService remote.DriverService}<tr><td><a id="l27"></a><a href="#l27">27</a><td> * that manages the [ChromeDriver] child process.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * 2. {@linkplain Options}: defines configuration options for each new Chrome<tr><td><a id="l30"></a><a href="#l30">30</a><td> * session, such as which {@linkplain Options#setProxy proxy} to use,<tr><td><a id="l31"></a><a href="#l31">31</a><td> * what {@linkplain Options#addExtensions extensions} to install, or<tr><td><a id="l32"></a><a href="#l32">32</a><td> * what {@linkplain Options#addArguments command-line switches} to use when<tr><td><a id="l33"></a><a href="#l33">33</a><td> * starting the browser.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * 3. {@linkplain Driver}: the WebDriver client; each new instance will control<tr><td><a id="l36"></a><a href="#l36">36</a><td> * a unique browser session with a clean user profile (unless otherwise<tr><td><a id="l37"></a><a href="#l37">37</a><td> * configured through the {@link Options} class).<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * __Customizing the ChromeDriver Server__ &lt;a id=&quot;custom-server&quot;&gt;&lt;/a&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> * By default, every Chrome session will use a single driver service, which is<tr><td><a id="l42"></a><a href="#l42">42</a><td> * started the first time a {@link Driver} instance is created and terminated<tr><td><a id="l43"></a><a href="#l43">43</a><td> * when this process exits. The default service will inherit its environment<tr><td><a id="l44"></a><a href="#l44">44</a><td> * from the current process and direct all output to /dev/null. You may obtain<tr><td><a id="l45"></a><a href="#l45">45</a><td> * a handle to this default service using<tr><td><a id="l46"></a><a href="#l46">46</a><td> * {@link #getDefaultService getDefaultService()} and change its configuration<tr><td><a id="l47"></a><a href="#l47">47</a><td> * with {@link #setDefaultService setDefaultService()}.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * You may also create a {@link Driver} with its own driver service. This is<tr><td><a id="l50"></a><a href="#l50">50</a><td> * useful if you need to capture the server&#39;s log output for a specific session:<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * var chrome = require(&#39;selenium-webdriver/chrome&#39;);<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 service = new chrome.ServiceBuilder()<tr><td><a id="l55"></a><a href="#l55">55</a><td> * .loggingTo(&#39;/my/log/file.txt&#39;)<tr><td><a id="l56"></a><a href="#l56">56</a><td> * .enableVerboseLogging()<tr><td><a id="l57"></a><a href="#l57">57</a><td> * .build();<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * var options = new chrome.Options();<tr><td><a id="l60"></a><a href="#l60">60</a><td> * // configure browser 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> * var driver = new chrome.Driver(options, service);<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * Users should only instantiate the {@link Driver} class directly when they<tr><td><a id="l65"></a><a href="#l65">65</a><td> * need a custom driver service configuration (as shown above). For normal<tr><td><a id="l66"></a><a href="#l66">66</a><td> * operation, users should start Chrome using the<tr><td><a id="l67"></a><a href="#l67">67</a><td> * {@link selenium-webdriver.Builder}.<tr><td><a id="l68"></a><a href="#l68">68</a><td> *<tr><td><a id="l69"></a><a href="#l69">69</a><td> * __Working with Android__ &lt;a id=&quot;android&quot;&gt;&lt;/a&gt;<tr><td><a id="l70"></a><a href="#l70">70</a><td> *<tr><td><a id="l71"></a><a href="#l71">71</a><td> * The [ChromeDriver][android] supports running tests on the Chrome browser as<tr><td><a id="l72"></a><a href="#l72">72</a><td> * well as [WebView apps][webview] starting in Android 4.4 (KitKat). In order to<tr><td><a id="l73"></a><a href="#l73">73</a><td> * work with Android, you must first start the adb<tr><td><a id="l74"></a><a href="#l74">74</a><td> *<tr><td><a id="l75"></a><a href="#l75">75</a><td> * adb start-server<tr><td><a id="l76"></a><a href="#l76">76</a><td> *<tr><td><a id="l77"></a><a href="#l77">77</a><td> * By default, adb will start on port 5037. You may change this port, but this<tr><td><a id="l78"></a><a href="#l78">78</a><td> * will require configuring a [custom server](#custom-server) that will connect<tr><td><a id="l79"></a><a href="#l79">79</a><td> * to adb on the {@linkplain ServiceBuilder#setAdbPort correct port}:<tr><td><a id="l80"></a><a href="#l80">80</a><td> *<tr><td><a id="l81"></a><a href="#l81">81</a><td> * var service = new chrome.ServiceBuilder()<tr><td><a id="l82"></a><a href="#l82">82</a><td> * .setAdbPort(1234)<tr><td><a id="l83"></a><a href="#l83">83</a><td> * build();<tr><td><a id="l84"></a><a href="#l84">84</a><td> * // etc.<tr><td><a id="l85"></a><a href="#l85">85</a><td> *<tr><td><a id="l86"></a><a href="#l86">86</a><td> * The ChromeDriver may be configured to launch Chrome on Android using<tr><td><a id="l87"></a><a href="#l87">87</a><td> * {@link Options#androidChrome()}:<tr><td><a id="l88"></a><a href="#l88">88</a><td> *<tr><td><a id="l89"></a><a href="#l89">89</a><td> * var driver = new Builder()<tr><td><a id="l90"></a><a href="#l90">90</a><td> * .forBrowser(&#39;chrome&#39;)<tr><td><a id="l91"></a><a href="#l91">91</a><td> * .setChromeOptions(new chrome.Options().androidChrome())<tr><td><a id="l92"></a><a href="#l92">92</a><td> * .build();<tr><td><a id="l93"></a><a href="#l93">93</a><td> *<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Alternatively, you can configure the ChromeDriver to launch an app with a<tr><td><a id="l95"></a><a href="#l95">95</a><td> * Chrome-WebView by setting the {@linkplain Options#androidActivity<tr><td><a id="l96"></a><a href="#l96">96</a><td> * androidActivity} option:<tr><td><a id="l97"></a><a href="#l97">97</a><td> *<tr><td><a id="l98"></a><a href="#l98">98</a><td> * var driver = new Builder()<tr><td><a id="l99"></a><a href="#l99">99</a><td> * .forBrowser(&#39;chrome&#39;)<tr><td><a id="l100"></a><a href="#l100">100</a><td> * .setChromeOptions(new chrome.Options()<tr><td><a id="l101"></a><a href="#l101">101</a><td> * .androidPackage(&#39;com.example&#39;)<tr><td><a id="l102"></a><a href="#l102">102</a><td> * .androidActivity(&#39;com.example.Activity&#39;))<tr><td><a id="l103"></a><a href="#l103">103</a><td> * .build();<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * [Refer to the ChromeDriver site] for more information on using the<tr><td><a id="l106"></a><a href="#l106">106</a><td> * [ChromeDriver with Android][android].<tr><td><a id="l107"></a><a href="#l107">107</a><td> *<tr><td><a id="l108"></a><a href="#l108">108</a><td> * [ChromeDriver]: https://sites.google.com/a/chromium.org/chromedriver/<tr><td><a id="l109"></a><a href="#l109">109</a><td> * [ChromeDriver release]: http://chromedriver.storage.googleapis.com/index.html<tr><td><a id="l110"></a><a href="#l110">110</a><td> * [PATH]: http://en.wikipedia.org/wiki/PATH_%28variable%29<tr><td><a id="l111"></a><a href="#l111">111</a><td> * [android]: https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android<tr><td><a id="l112"></a><a href="#l112">112</a><td> * [webview]: https://developer.chrome.com/multidevice/webview/overview<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>&#39;use strict&#39;;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l118"></a><a href="#l118">118</a><td> util = require(&#39;util&#39;);<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l121"></a><a href="#l121">121</a><td> executors = require(&#39;./executors&#39;),<tr><td><a id="l122"></a><a href="#l122">122</a><td> http = require(&#39;./http&#39;),<tr><td><a id="l123"></a><a href="#l123">123</a><td> io = require(&#39;./io&#39;),<tr><td><a id="l124"></a><a href="#l124">124</a><td> portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l125"></a><a href="#l125">125</a><td> remote = require(&#39;./remote&#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><tr><td><a id="l128"></a><a href="#l128">128</a><td>/**<tr><td><a id="l129"></a><a href="#l129">129</a><td> * Name of the ChromeDriver executable.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @type {string}<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @const<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>var CHROMEDRIVER_EXE =<tr><td><a id="l134"></a><a href="#l134">134</a><td> process.platform === &#39;win32&#39; ? &#39;chromedriver.exe&#39; : &#39;chromedriver&#39;;<tr><td><a id="l135"></a><a href="#l135">135</a><td><tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Custom command names supported by ChromeDriver.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @enum {string}<tr><td><a id="l140"></a><a href="#l140">140</a><td> */<tr><td><a id="l141"></a><a href="#l141">141</a><td>var Command = {<tr><td><a id="l142"></a><a href="#l142">142</a><td> LAUNCH_APP: &#39;launchApp&#39;<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> * Creates a command executor with support for ChromeDriver&#39;s custom commands.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {!webdriver.promise.Promise&lt;string&gt;} url The server&#39;s URL.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @return {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l150"></a><a href="#l150">150</a><td> */<tr><td><a id="l151"></a><a href="#l151">151</a><td>function createExecutor(url) {<tr><td><a id="l152"></a><a href="#l152">152</a><td> return new executors.DeferredExecutor(url.then(function(url) {<tr><td><a id="l153"></a><a href="#l153">153</a><td> var client = new http.HttpClient(url);<tr><td><a id="l154"></a><a href="#l154">154</a><td> var executor = new http.Executor(client);<tr><td><a id="l155"></a><a href="#l155">155</a><td> executor.defineCommand(<tr><td><a id="l156"></a><a href="#l156">156</a><td> Command.LAUNCH_APP,<tr><td><a id="l157"></a><a href="#l157">157</a><td> &#39;POST&#39;, &#39;/session/:sessionId/chromium/launch_app&#39;);<tr><td><a id="l158"></a><a href="#l158">158</a><td> return executor;<tr><td><a id="l159"></a><a href="#l159">159</a><td> }));<tr><td><a id="l160"></a><a href="#l160">160</a><td>}<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Creates {@link selenium-webdriver/remote.DriverService} instances that manage<tr><td><a id="l165"></a><a href="#l165">165</a><td> * a [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)<tr><td><a id="l166"></a><a href="#l166">166</a><td> * server in a child process.<tr><td><a id="l167"></a><a href="#l167">167</a><td> *<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @param {string=} opt_exe Path to the server executable to use. If omitted,<tr><td><a id="l169"></a><a href="#l169">169</a><td> * the builder will attempt to locate the chromedriver on the current<tr><td><a id="l170"></a><a href="#l170">170</a><td> * PATH.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @throws {Error} If provided executable does not exist, or the chromedriver<tr><td><a id="l172"></a><a href="#l172">172</a><td> * cannot be found on the PATH.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @constructor<tr><td><a id="l174"></a><a href="#l174">174</a><td> */<tr><td><a id="l175"></a><a href="#l175">175</a><td>var ServiceBuilder = function(opt_exe) {<tr><td><a id="l176"></a><a href="#l176">176</a><td> /** @private {string} */<tr><td><a id="l177"></a><a href="#l177">177</a><td> this.exe_ = opt_exe || io.findInPath(CHROMEDRIVER_EXE, true);<tr><td><a id="l178"></a><a href="#l178">178</a><td> if (!this.exe_) {<tr><td><a id="l179"></a><a href="#l179">179</a><td> throw Error(<tr><td><a id="l180"></a><a href="#l180">180</a><td> &#39;The ChromeDriver could not be found on the current PATH. Please &#39; +<tr><td><a id="l181"></a><a href="#l181">181</a><td> &#39;download the latest version of the ChromeDriver from &#39; +<tr><td><a id="l182"></a><a href="#l182">182</a><td> &#39;http://chromedriver.storage.googleapis.com/index.html and ensure &#39; +<tr><td><a id="l183"></a><a href="#l183">183</a><td> &#39;it can be found on your PATH.&#39;);<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> if (!fs.existsSync(this.exe_)) {<tr><td><a id="l187"></a><a href="#l187">187</a><td> throw Error(&#39;File does not exist: &#39; + this.exe_);<tr><td><a id="l188"></a><a href="#l188">188</a><td> }<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td> /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l191"></a><a href="#l191">191</a><td> this.args_ = [];<tr><td><a id="l192"></a><a href="#l192">192</a><td> this.stdio_ = &#39;ignore&#39;;<tr><td><a id="l193"></a><a href="#l193">193</a><td>};<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>/** @private {string} */<tr><td><a id="l197"></a><a href="#l197">197</a><td>ServiceBuilder.prototype.path_ = null;<tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/** @private {number} */<tr><td><a id="l200"></a><a href="#l200">200</a><td>ServiceBuilder.prototype.port_ = 0;<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>/** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a id="l204"></a><a href="#l204">204</a><td>ServiceBuilder.prototype.stdio_ = &#39;ignore&#39;;<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>/** @private {Object.&lt;string, string&gt;} */<tr><td><a id="l208"></a><a href="#l208">208</a><td>ServiceBuilder.prototype.env_ = null;<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> * Sets the port to start the ChromeDriver on.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @param {number} port The port to use, or 0 for any free port.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @throws {Error} If the port is invalid.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>ServiceBuilder.prototype.usingPort = function(port) {<tr><td><a id="l218"></a><a href="#l218">218</a><td> if (port &lt; 0) {<tr><td><a id="l219"></a><a href="#l219">219</a><td> throw Error(&#39;port must be &gt;= 0: &#39; + port);<tr><td><a id="l220"></a><a href="#l220">220</a><td> }<tr><td><a id="l221"></a><a href="#l221">221</a><td> this.port_ = port;<tr><td><a id="l222"></a><a href="#l222">222</a><td> return this;<tr><td><a id="l223"></a><a href="#l223">223</a><td>};<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>/**<tr><td><a id="l227"></a><a href="#l227">227</a><td> * Sets which port adb is listening to. _The ChromeDriver will connect to adb<tr><td><a id="l228"></a><a href="#l228">228</a><td> * if an {@linkplain Options#androidPackage Android session} is requested, but<tr><td><a id="l229"></a><a href="#l229">229</a><td> * adb **must** be started beforehand._<tr><td><a id="l230"></a><a href="#l230">230</a><td> *<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @param {number} port Which port adb is running on.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>ServiceBuilder.prototype.setAdbPort = function(port) {<tr><td><a id="l235"></a><a href="#l235">235</a><td> this.args_.push(&#39;--adb-port=&#39; + port);<tr><td><a id="l236"></a><a href="#l236">236</a><td> return this;<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><tr><td><a id="l240"></a><a href="#l240">240</a><td>/**<tr><td><a id="l241"></a><a href="#l241">241</a><td> * Sets the path of the log file the driver should log to. If a log file is<tr><td><a id="l242"></a><a href="#l242">242</a><td> * not specified, the driver will log to stderr.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {string} path Path of the log file to use.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>ServiceBuilder.prototype.loggingTo = function(path) {<tr><td><a id="l247"></a><a href="#l247">247</a><td> this.args_.push(&#39;--log-path=&#39; + path);<tr><td><a id="l248"></a><a href="#l248">248</a><td> return this;<tr><td><a id="l249"></a><a href="#l249">249</a><td>};<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> * Enables verbose logging.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>ServiceBuilder.prototype.enableVerboseLogging = function() {<tr><td><a id="l257"></a><a href="#l257">257</a><td> this.args_.push(&#39;--verbose&#39;);<tr><td><a id="l258"></a><a href="#l258">258</a><td> return this;<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<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> * Sets the number of threads the driver should use to manage HTTP requests.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * By default, the driver will use 4 threads.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {number} n The number of threads to use.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>ServiceBuilder.prototype.setNumHttpThreads = function(n) {<tr><td><a id="l269"></a><a href="#l269">269</a><td> this.args_.push(&#39;--http-threads=&#39; + n);<tr><td><a id="l270"></a><a href="#l270">270</a><td> return this;<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<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> * Sets the base path for WebDriver REST commands (e.g. &quot;/wd/hub&quot;).<tr><td><a id="l276"></a><a href="#l276">276</a><td> * By default, the driver will accept commands relative to &quot;/&quot;.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {string} path The base path to use.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l279"></a><a href="#l279">279</a><td> */<tr><td><a id="l280"></a><a href="#l280">280</a><td>ServiceBuilder.prototype.setUrlBasePath = function(path) {<tr><td><a id="l281"></a><a href="#l281">281</a><td> this.args_.push(&#39;--url-base=&#39; + path);<tr><td><a id="l282"></a><a href="#l282">282</a><td> this.path_ = path;<tr><td><a id="l283"></a><a href="#l283">283</a><td> return this;<tr><td><a id="l284"></a><a href="#l284">284</a><td>};<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * Defines the stdio configuration for the driver service. See<tr><td><a id="l289"></a><a href="#l289">289</a><td> * {@code child_process.spawn} for more information.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} config The<tr><td><a id="l291"></a><a href="#l291">291</a><td> * configuration to use.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>ServiceBuilder.prototype.setStdio = function(config) {<tr><td><a id="l295"></a><a href="#l295">295</a><td> this.stdio_ = config;<tr><td><a id="l296"></a><a href="#l296">296</a><td> return this;<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Defines the environment to start the server under. This settings will be<tr><td><a id="l302"></a><a href="#l302">302</a><td> * inherited by every browser session started by the server.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {!Object.&lt;string, string&gt;} env The environment to use.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l305"></a><a href="#l305">305</a><td> */<tr><td><a id="l306"></a><a href="#l306">306</a><td>ServiceBuilder.prototype.withEnvironment = function(env) {<tr><td><a id="l307"></a><a href="#l307">307</a><td> this.env_ = env;<tr><td><a id="l308"></a><a href="#l308">308</a><td> return this;<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Creates a new DriverService using this instance&#39;s current configuration.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @return {remote.DriverService} A new driver service using this instance&#39;s<tr><td><a id="l315"></a><a href="#l315">315</a><td> * current configuration.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @throws {Error} If the driver exectuable was not specified and a default<tr><td><a id="l317"></a><a href="#l317">317</a><td> * could not be found on the current PATH.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>ServiceBuilder.prototype.build = function() {<tr><td><a id="l320"></a><a href="#l320">320</a><td> var port = this.port_ || portprober.findFreePort();<tr><td><a id="l321"></a><a href="#l321">321</a><td> var args = this.args_.concat(); // Defensive copy.<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td> return new remote.DriverService(this.exe_, {<tr><td><a id="l324"></a><a href="#l324">324</a><td> loopback: true,<tr><td><a id="l325"></a><a href="#l325">325</a><td> path: this.path_,<tr><td><a id="l326"></a><a href="#l326">326</a><td> port: port,<tr><td><a id="l327"></a><a href="#l327">327</a><td> args: webdriver.promise.when(port, function(port) {<tr><td><a id="l328"></a><a href="#l328">328</a><td> return args.concat(&#39;--port=&#39; + port);<tr><td><a id="l329"></a><a href="#l329">329</a><td> }),<tr><td><a id="l330"></a><a href="#l330">330</a><td> env: this.env_,<tr><td><a id="l331"></a><a href="#l331">331</a><td> stdio: this.stdio_<tr><td><a id="l332"></a><a href="#l332">332</a><td> });<tr><td><a id="l333"></a><a href="#l333">333</a><td>};<tr><td><a id="l334"></a><a href="#l334">334</a><td><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/** @type {remote.DriverService} */<tr><td><a id="l337"></a><a href="#l337">337</a><td>var defaultService = null;<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Sets the default service to use for new ChromeDriver instances.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {!remote.DriverService} service The service to use.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @throws {Error} If the default service is currently running.<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>function setDefaultService(service) {<tr><td><a id="l346"></a><a href="#l346">346</a><td> if (defaultService &amp;&amp; defaultService.isRunning()) {<tr><td><a id="l347"></a><a href="#l347">347</a><td> throw Error(<tr><td><a id="l348"></a><a href="#l348">348</a><td> &#39;The previously configured ChromeDriver service is still running. &#39; +<tr><td><a id="l349"></a><a href="#l349">349</a><td> &#39;You must shut it down before you may adjust its configuration.&#39;);<tr><td><a id="l350"></a><a href="#l350">350</a><td> }<tr><td><a id="l351"></a><a href="#l351">351</a><td> defaultService = service;<tr><td><a id="l352"></a><a href="#l352">352</a><td>}<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Returns the default ChromeDriver service. If such a service has not been<tr><td><a id="l357"></a><a href="#l357">357</a><td> * configured, one will be constructed using the default configuration for<tr><td><a id="l358"></a><a href="#l358">358</a><td> * a ChromeDriver executable found on the system PATH.<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @return {!remote.DriverService} The default ChromeDriver service.<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>function getDefaultService() {<tr><td><a id="l362"></a><a href="#l362">362</a><td> if (!defaultService) {<tr><td><a id="l363"></a><a href="#l363">363</a><td> defaultService = new ServiceBuilder().build();<tr><td><a id="l364"></a><a href="#l364">364</a><td> }<tr><td><a id="l365"></a><a href="#l365">365</a><td> return defaultService;<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>/**<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @type {string}<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @const<tr><td><a id="l372"></a><a href="#l372">372</a><td> */<tr><td><a id="l373"></a><a href="#l373">373</a><td>var OPTIONS_CAPABILITY_KEY = &#39;chromeOptions&#39;;<tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Class for managing ChromeDriver specific options.<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @constructor<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @extends {webdriver.Serializable}<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>var Options = function() {<tr><td><a id="l382"></a><a href="#l382">382</a><td> webdriver.Serializable.call(this);<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td> /** @private {!Object} */<tr><td><a id="l385"></a><a href="#l385">385</a><td> this.options_ = {};<tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td> /** @private {!Array.&lt;(string|!Buffer)&gt;} */<tr><td><a id="l388"></a><a href="#l388">388</a><td> this.extensions_ = [];<tr><td><a id="l389"></a><a href="#l389">389</a><td><tr><td><a id="l390"></a><a href="#l390">390</a><td> /** @private {?webdriver.logging.Preferences} */<tr><td><a id="l391"></a><a href="#l391">391</a><td> this.logPrefs_ = null;<tr><td><a id="l392"></a><a href="#l392">392</a><td><tr><td><a id="l393"></a><a href="#l393">393</a><td> /** @private {?webdriver.ProxyConfig} */<tr><td><a id="l394"></a><a href="#l394">394</a><td> this.proxy_ = null;<tr><td><a id="l395"></a><a href="#l395">395</a><td>};<tr><td><a id="l396"></a><a href="#l396">396</a><td>util.inherits(Options, webdriver.Serializable);<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td>/**<tr><td><a id="l400"></a><a href="#l400">400</a><td> * Extracts the ChromeDriver specific options from the given capabilities<tr><td><a id="l401"></a><a href="#l401">401</a><td> * object.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @return {!Options} The ChromeDriver options.<tr><td><a id="l404"></a><a href="#l404">404</a><td> */<tr><td><a id="l405"></a><a href="#l405">405</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l406"></a><a href="#l406">406</a><td> var options = new Options();<tr><td><a id="l407"></a><a href="#l407">407</a><td><tr><td><a id="l408"></a><a href="#l408">408</a><td> var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a id="l409"></a><a href="#l409">409</a><td> if (o instanceof Options) {<tr><td><a id="l410"></a><a href="#l410">410</a><td> options = o;<tr><td><a id="l411"></a><a href="#l411">411</a><td> } else if (o) {<tr><td><a id="l412"></a><a href="#l412">412</a><td> options.<tr><td><a id="l413"></a><a href="#l413">413</a><td> addArguments(o.args || []).<tr><td><a id="l414"></a><a href="#l414">414</a><td> addExtensions(o.extensions || []).<tr><td><a id="l415"></a><a href="#l415">415</a><td> detachDriver(o.detach).<tr><td><a id="l416"></a><a href="#l416">416</a><td> excludeSwitches(o.excludeSwitches || []).<tr><td><a id="l417"></a><a href="#l417">417</a><td> setChromeBinaryPath(o.binary).<tr><td><a id="l418"></a><a href="#l418">418</a><td> setChromeLogFile(o.logPath).<tr><td><a id="l419"></a><a href="#l419">419</a><td> setChromeMinidumpPath(o.minidumpPath).<tr><td><a id="l420"></a><a href="#l420">420</a><td> setLocalState(o.localState).<tr><td><a id="l421"></a><a href="#l421">421</a><td> setMobileEmulation(o.mobileEmulation).<tr><td><a id="l422"></a><a href="#l422">422</a><td> setUserPreferences(o.prefs).<tr><td><a id="l423"></a><a href="#l423">423</a><td> setPerfLoggingPrefs(o.perfLoggingPrefs);<tr><td><a id="l424"></a><a href="#l424">424</a><td> }<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td> if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a id="l427"></a><a href="#l427">427</a><td> options.setProxy(capabilities.get(webdriver.Capability.PROXY));<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 (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a id="l431"></a><a href="#l431">431</a><td> options.setLoggingPrefs(<tr><td><a id="l432"></a><a href="#l432">432</a><td> capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a id="l433"></a><a href="#l433">433</a><td> }<tr><td><a id="l434"></a><a href="#l434">434</a><td><tr><td><a id="l435"></a><a href="#l435">435</a><td> return options;<tr><td><a id="l436"></a><a href="#l436">436</a><td>};<tr><td><a id="l437"></a><a href="#l437">437</a><td><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> * Add additional command line arguments to use when launching the Chrome<tr><td><a id="l441"></a><a href="#l441">441</a><td> * browser. Each argument may be specified with or without the &quot;--&quot; prefix<tr><td><a id="l442"></a><a href="#l442">442</a><td> * (e.g. &quot;--foo&quot; and &quot;foo&quot;). Arguments with an associated value should be<tr><td><a id="l443"></a><a href="#l443">443</a><td> * delimited by an &quot;=&quot;: &quot;foo=bar&quot;.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @return {!Options} A self reference.<tr><td><a id="l446"></a><a href="#l446">446</a><td> */<tr><td><a id="l447"></a><a href="#l447">447</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a id="l448"></a><a href="#l448">448</a><td> var args = this.options_.args || [];<tr><td><a id="l449"></a><a href="#l449">449</a><td> args = args.concat.apply(args, arguments);<tr><td><a id="l450"></a><a href="#l450">450</a><td> if (args.length) {<tr><td><a id="l451"></a><a href="#l451">451</a><td> this.options_.args = args;<tr><td><a id="l452"></a><a href="#l452">452</a><td> }<tr><td><a id="l453"></a><a href="#l453">453</a><td> return this;<tr><td><a id="l454"></a><a href="#l454">454</a><td>};<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>/**<tr><td><a id="l458"></a><a href="#l458">458</a><td> * List of Chrome command line switches to exclude that ChromeDriver by default<tr><td><a id="l459"></a><a href="#l459">459</a><td> * passes when starting Chrome. Do not prefix switches with &quot;--&quot;.<tr><td><a id="l460"></a><a href="#l460">460</a><td> *<tr><td><a id="l461"></a><a href="#l461">461</a><td> * @param {...(string|!Array&lt;string&gt;)} var_args The switches to exclude.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {!Options} A self reference.<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td>Options.prototype.excludeSwitches = function(var_args) {<tr><td><a id="l465"></a><a href="#l465">465</a><td> var switches = this.options_.excludeSwitches || [];<tr><td><a id="l466"></a><a href="#l466">466</a><td> switches = switches.concat.apply(switches, arguments);<tr><td><a id="l467"></a><a href="#l467">467</a><td> if (switches.length) {<tr><td><a id="l468"></a><a href="#l468">468</a><td> this.options_.excludeSwitches = switches;<tr><td><a id="l469"></a><a href="#l469">469</a><td> }<tr><td><a id="l470"></a><a href="#l470">470</a><td> return this;<tr><td><a id="l471"></a><a href="#l471">471</a><td>};<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>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Add additional extensions to install when launching Chrome. Each extension<tr><td><a id="l476"></a><a href="#l476">476</a><td> * should be specified as the path to the packed CRX file, or a Buffer for an<tr><td><a id="l477"></a><a href="#l477">477</a><td> * extension.<tr><td><a id="l478"></a><a href="#l478">478</a><td> * @param {...(string|!Buffer|!Array.&lt;(string|!Buffer)&gt;)} var_args The<tr><td><a id="l479"></a><a href="#l479">479</a><td> * extensions to add.<tr><td><a id="l480"></a><a href="#l480">480</a><td> * @return {!Options} A self reference.<tr><td><a id="l481"></a><a href="#l481">481</a><td> */<tr><td><a id="l482"></a><a href="#l482">482</a><td>Options.prototype.addExtensions = function(var_args) {<tr><td><a id="l483"></a><a href="#l483">483</a><td> this.extensions_ = this.extensions_.concat.apply(this.extensions_, arguments);<tr><td><a id="l484"></a><a href="#l484">484</a><td> return this;<tr><td><a id="l485"></a><a href="#l485">485</a><td>};<tr><td><a id="l486"></a><a href="#l486">486</a><td><tr><td><a id="l487"></a><a href="#l487">487</a><td><tr><td><a id="l488"></a><a href="#l488">488</a><td>/**<tr><td><a id="l489"></a><a href="#l489">489</a><td> * Sets the path to the Chrome binary to use. On Mac OS X, this path should<tr><td><a id="l490"></a><a href="#l490">490</a><td> * reference the actual Chrome executable, not just the application binary<tr><td><a id="l491"></a><a href="#l491">491</a><td> * (e.g. &quot;/Applications/Google Chrome.app/Contents/MacOS/Google Chrome&quot;).<tr><td><a id="l492"></a><a href="#l492">492</a><td> *<tr><td><a id="l493"></a><a href="#l493">493</a><td> * The binary path be absolute or relative to the chromedriver server<tr><td><a id="l494"></a><a href="#l494">494</a><td> * executable, but it must exist on the machine that will launch Chrome.<tr><td><a id="l495"></a><a href="#l495">495</a><td> *<tr><td><a id="l496"></a><a href="#l496">496</a><td> * @param {string} path The path to the Chrome binary to use.<tr><td><a id="l497"></a><a href="#l497">497</a><td> * @return {!Options} A self reference.<tr><td><a id="l498"></a><a href="#l498">498</a><td> */<tr><td><a id="l499"></a><a href="#l499">499</a><td>Options.prototype.setChromeBinaryPath = function(path) {<tr><td><a id="l500"></a><a href="#l500">500</a><td> this.options_.binary = path;<tr><td><a id="l501"></a><a href="#l501">501</a><td> return this;<tr><td><a id="l502"></a><a href="#l502">502</a><td>};<tr><td><a id="l503"></a><a href="#l503">503</a><td><tr><td><a id="l504"></a><a href="#l504">504</a><td><tr><td><a id="l505"></a><a href="#l505">505</a><td>/**<tr><td><a id="l506"></a><a href="#l506">506</a><td> * Sets whether to leave the started Chrome browser running if the controlling<tr><td><a id="l507"></a><a href="#l507">507</a><td> * ChromeDriver service is killed before {@link webdriver.WebDriver#quit()} is<tr><td><a id="l508"></a><a href="#l508">508</a><td> * called.<tr><td><a id="l509"></a><a href="#l509">509</a><td> * @param {boolean} detach Whether to leave the browser running if the<tr><td><a id="l510"></a><a href="#l510">510</a><td> * chromedriver service is killed before the session.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @return {!Options} A self reference.<tr><td><a id="l512"></a><a href="#l512">512</a><td> */<tr><td><a id="l513"></a><a href="#l513">513</a><td>Options.prototype.detachDriver = function(detach) {<tr><td><a id="l514"></a><a href="#l514">514</a><td> this.options_.detach = detach;<tr><td><a id="l515"></a><a href="#l515">515</a><td> return this;<tr><td><a id="l516"></a><a href="#l516">516</a><td>};<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td>/**<tr><td><a id="l520"></a><a href="#l520">520</a><td> * Sets the user preferences for Chrome&#39;s user profile. See the &quot;Preferences&quot;<tr><td><a id="l521"></a><a href="#l521">521</a><td> * file in Chrome&#39;s user data directory for examples.<tr><td><a id="l522"></a><a href="#l522">522</a><td> * @param {!Object} prefs Dictionary of user preferences to use.<tr><td><a id="l523"></a><a href="#l523">523</a><td> * @return {!Options} A self reference.<tr><td><a id="l524"></a><a href="#l524">524</a><td> */<tr><td><a id="l525"></a><a href="#l525">525</a><td>Options.prototype.setUserPreferences = function(prefs) {<tr><td><a id="l526"></a><a href="#l526">526</a><td> this.options_.prefs = prefs;<tr><td><a id="l527"></a><a href="#l527">527</a><td> return this;<tr><td><a id="l528"></a><a href="#l528">528</a><td>};<tr><td><a id="l529"></a><a href="#l529">529</a><td><tr><td><a id="l530"></a><a href="#l530">530</a><td><tr><td><a id="l531"></a><a href="#l531">531</a><td>/**<tr><td><a id="l532"></a><a href="#l532">532</a><td> * Sets the logging preferences for the new session.<tr><td><a id="l533"></a><a href="#l533">533</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @return {!Options} A self reference.<tr><td><a id="l535"></a><a href="#l535">535</a><td> */<tr><td><a id="l536"></a><a href="#l536">536</a><td>Options.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l537"></a><a href="#l537">537</a><td> this.logPrefs_ = prefs;<tr><td><a id="l538"></a><a href="#l538">538</a><td> return this;<tr><td><a id="l539"></a><a href="#l539">539</a><td>};<tr><td><a id="l540"></a><a href="#l540">540</a><td><tr><td><a id="l541"></a><a href="#l541">541</a><td><tr><td><a id="l542"></a><a href="#l542">542</a><td>/**<tr><td><a id="l543"></a><a href="#l543">543</a><td> * Sets the performance logging preferences. Options include:<tr><td><a id="l544"></a><a href="#l544">544</a><td> *<tr><td><a id="l545"></a><a href="#l545">545</a><td> * - `enableNetwork`: Whether or not to collect events from Network domain.<tr><td><a id="l546"></a><a href="#l546">546</a><td> * - `enablePage`: Whether or not to collect events from Page domain.<tr><td><a id="l547"></a><a href="#l547">547</a><td> * - `enableTimeline`: Whether or not to collect events from Timeline domain.<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Note: when tracing is enabled, Timeline domain is implicitly disabled,<tr><td><a id="l549"></a><a href="#l549">549</a><td> * unless `enableTimeline` is explicitly set to true.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * - `tracingCategories`: A comma-separated string of Chrome tracing categories<tr><td><a id="l551"></a><a href="#l551">551</a><td> * for which trace events should be collected. An unspecified or empty<tr><td><a id="l552"></a><a href="#l552">552</a><td> * string disables tracing.<tr><td><a id="l553"></a><a href="#l553">553</a><td> * - `bufferUsageReportingInterval`: The requested number of milliseconds<tr><td><a id="l554"></a><a href="#l554">554</a><td> * between DevTools trace buffer usage events. For example, if 1000, then<tr><td><a id="l555"></a><a href="#l555">555</a><td> * once per second, DevTools will report how full the trace buffer is. If a<tr><td><a id="l556"></a><a href="#l556">556</a><td> * report indicates the buffer usage is 100%, a warning will be issued.<tr><td><a id="l557"></a><a href="#l557">557</a><td> *<tr><td><a id="l558"></a><a href="#l558">558</a><td> * @param {{enableNetwork: boolean,<tr><td><a id="l559"></a><a href="#l559">559</a><td> * enablePage: boolean,<tr><td><a id="l560"></a><a href="#l560">560</a><td> * enableTimeline: boolean,<tr><td><a id="l561"></a><a href="#l561">561</a><td> * tracingCategories: string,<tr><td><a id="l562"></a><a href="#l562">562</a><td> * bufferUsageReportingInterval: number}} prefs The performance<tr><td><a id="l563"></a><a href="#l563">563</a><td> * logging preferences.<tr><td><a id="l564"></a><a href="#l564">564</a><td> * @return {!Options} A self reference.<tr><td><a id="l565"></a><a href="#l565">565</a><td> */<tr><td><a id="l566"></a><a href="#l566">566</a><td>Options.prototype.setPerfLoggingPrefs = function(prefs) {<tr><td><a id="l567"></a><a href="#l567">567</a><td> this.options_.perfLoggingPrefs = prefs;<tr><td><a id="l568"></a><a href="#l568">568</a><td> return this;<tr><td><a id="l569"></a><a href="#l569">569</a><td>};<tr><td><a id="l570"></a><a href="#l570">570</a><td><tr><td><a id="l571"></a><a href="#l571">571</a><td><tr><td><a id="l572"></a><a href="#l572">572</a><td>/**<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Sets preferences for the &quot;Local State&quot; file in Chrome&#39;s user data<tr><td><a id="l574"></a><a href="#l574">574</a><td> * directory.<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @param {!Object} state Dictionary of local state preferences.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @return {!Options} A self reference.<tr><td><a id="l577"></a><a href="#l577">577</a><td> */<tr><td><a id="l578"></a><a href="#l578">578</a><td>Options.prototype.setLocalState = function(state) {<tr><td><a id="l579"></a><a href="#l579">579</a><td> this.options_.localState = state;<tr><td><a id="l580"></a><a href="#l580">580</a><td> return this;<tr><td><a id="l581"></a><a href="#l581">581</a><td>};<tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td>/**<tr><td><a id="l585"></a><a href="#l585">585</a><td> * Sets the name of the activity hosting a Chrome-based Android WebView. This<tr><td><a id="l586"></a><a href="#l586">586</a><td> * option must be set to connect to an [Android WebView](<tr><td><a id="l587"></a><a href="#l587">587</a><td> * https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android)<tr><td><a id="l588"></a><a href="#l588">588</a><td> *<tr><td><a id="l589"></a><a href="#l589">589</a><td> * @param {string} name The activity name.<tr><td><a id="l590"></a><a href="#l590">590</a><td> * @return {!Options} A self reference.<tr><td><a id="l591"></a><a href="#l591">591</a><td> */<tr><td><a id="l592"></a><a href="#l592">592</a><td>Options.prototype.androidActivity = function(name) {<tr><td><a id="l593"></a><a href="#l593">593</a><td> this.options_.androidActivity = name;<tr><td><a id="l594"></a><a href="#l594">594</a><td> return this;<tr><td><a id="l595"></a><a href="#l595">595</a><td>};<tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td><tr><td><a id="l598"></a><a href="#l598">598</a><td>/**<tr><td><a id="l599"></a><a href="#l599">599</a><td> * Sets the device serial number to connect to via ADB. If not specified, the<tr><td><a id="l600"></a><a href="#l600">600</a><td> * ChromeDriver will select an unused device at random. An error will be<tr><td><a id="l601"></a><a href="#l601">601</a><td> * returned if all devices already have active sessions.<tr><td><a id="l602"></a><a href="#l602">602</a><td> *<tr><td><a id="l603"></a><a href="#l603">603</a><td> * @param {string} serial The device serial number to connect to.<tr><td><a id="l604"></a><a href="#l604">604</a><td> * @return {!Options} A self reference.<tr><td><a id="l605"></a><a href="#l605">605</a><td> */<tr><td><a id="l606"></a><a href="#l606">606</a><td>Options.prototype.androidDeviceSerial = function(serial) {<tr><td><a id="l607"></a><a href="#l607">607</a><td> this.options_.androidDeviceSerial = serial;<tr><td><a id="l608"></a><a href="#l608">608</a><td> return this;<tr><td><a id="l609"></a><a href="#l609">609</a><td>};<tr><td><a id="l610"></a><a href="#l610">610</a><td><tr><td><a id="l611"></a><a href="#l611">611</a><td><tr><td><a id="l612"></a><a href="#l612">612</a><td>/**<tr><td><a id="l613"></a><a href="#l613">613</a><td> * Configures the ChromeDriver to launch Chrome on Android via adb. This<tr><td><a id="l614"></a><a href="#l614">614</a><td> * function is shorthand for<tr><td><a id="l615"></a><a href="#l615">615</a><td> * {@link #androidPackage options.androidPackage(&#39;com.android.chrome&#39;)}.<tr><td><a id="l616"></a><a href="#l616">616</a><td> * @return {!Options} A self reference.<tr><td><a id="l617"></a><a href="#l617">617</a><td> */<tr><td><a id="l618"></a><a href="#l618">618</a><td>Options.prototype.androidChrome = function() {<tr><td><a id="l619"></a><a href="#l619">619</a><td> return this.androidPackage(&#39;com.android.chrome&#39;);<tr><td><a id="l620"></a><a href="#l620">620</a><td>};<tr><td><a id="l621"></a><a href="#l621">621</a><td><tr><td><a id="l622"></a><a href="#l622">622</a><td><tr><td><a id="l623"></a><a href="#l623">623</a><td>/**<tr><td><a id="l624"></a><a href="#l624">624</a><td> * Sets the package name of the Chrome or WebView app.<tr><td><a id="l625"></a><a href="#l625">625</a><td> *<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @param {?string} pkg The package to connect to, or `null` to disable Android<tr><td><a id="l627"></a><a href="#l627">627</a><td> * and switch back to using desktop Chrome.<tr><td><a id="l628"></a><a href="#l628">628</a><td> * @return {!Options} A self reference.<tr><td><a id="l629"></a><a href="#l629">629</a><td> */<tr><td><a id="l630"></a><a href="#l630">630</a><td>Options.prototype.androidPackage = function(pkg) {<tr><td><a id="l631"></a><a href="#l631">631</a><td> this.options_.androidPackage = pkg;<tr><td><a id="l632"></a><a href="#l632">632</a><td> return this;<tr><td><a id="l633"></a><a href="#l633">633</a><td>};<tr><td><a id="l634"></a><a href="#l634">634</a><td><tr><td><a id="l635"></a><a href="#l635">635</a><td><tr><td><a id="l636"></a><a href="#l636">636</a><td>/**<tr><td><a id="l637"></a><a href="#l637">637</a><td> * Sets the process name of the Activity hosting the WebView (as given by `ps`).<tr><td><a id="l638"></a><a href="#l638">638</a><td> * If not specified, the process name is assumed to be the same as<tr><td><a id="l639"></a><a href="#l639">639</a><td> * {@link #androidPackage}.<tr><td><a id="l640"></a><a href="#l640">640</a><td> *<tr><td><a id="l641"></a><a href="#l641">641</a><td> * @param {string} processName The main activity name.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {!Options} A self reference.<tr><td><a id="l643"></a><a href="#l643">643</a><td> */<tr><td><a id="l644"></a><a href="#l644">644</a><td>Options.prototype.androidProcess = function(processName) {<tr><td><a id="l645"></a><a href="#l645">645</a><td> this.options_.androidProcess = processName;<tr><td><a id="l646"></a><a href="#l646">646</a><td> return this;<tr><td><a id="l647"></a><a href="#l647">647</a><td>};<tr><td><a id="l648"></a><a href="#l648">648</a><td><tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td>/**<tr><td><a id="l651"></a><a href="#l651">651</a><td> * Sets whether to connect to an already-running instead of the specified<tr><td><a id="l652"></a><a href="#l652">652</a><td> * {@linkplain #androidProcess app} instead of launching the app with a clean<tr><td><a id="l653"></a><a href="#l653">653</a><td> * data directory.<tr><td><a id="l654"></a><a href="#l654">654</a><td> *<tr><td><a id="l655"></a><a href="#l655">655</a><td> * @param {boolean} useRunning Whether to connect to a running instance.<tr><td><a id="l656"></a><a href="#l656">656</a><td> * @return {!Options} A self reference.<tr><td><a id="l657"></a><a href="#l657">657</a><td> */<tr><td><a id="l658"></a><a href="#l658">658</a><td>Options.prototype.androidUseRunningApp = function(useRunning) {<tr><td><a id="l659"></a><a href="#l659">659</a><td> this.options_.androidUseRunningApp = useRunning;<tr><td><a id="l660"></a><a href="#l660">660</a><td> return this;<tr><td><a id="l661"></a><a href="#l661">661</a><td>};<tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td><tr><td><a id="l664"></a><a href="#l664">664</a><td>/**<tr><td><a id="l665"></a><a href="#l665">665</a><td> * Sets the path to Chrome&#39;s log file. This path should exist on the machine<tr><td><a id="l666"></a><a href="#l666">666</a><td> * that will launch Chrome.<tr><td><a id="l667"></a><a href="#l667">667</a><td> * @param {string} path Path to the log file to use.<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @return {!Options} A self reference.<tr><td><a id="l669"></a><a href="#l669">669</a><td> */<tr><td><a id="l670"></a><a href="#l670">670</a><td>Options.prototype.setChromeLogFile = function(path) {<tr><td><a id="l671"></a><a href="#l671">671</a><td> this.options_.logPath = path;<tr><td><a id="l672"></a><a href="#l672">672</a><td> return this;<tr><td><a id="l673"></a><a href="#l673">673</a><td>};<tr><td><a id="l674"></a><a href="#l674">674</a><td><tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>/**<tr><td><a id="l677"></a><a href="#l677">677</a><td> * Sets the directory to store Chrome minidumps in. This option is only<tr><td><a id="l678"></a><a href="#l678">678</a><td> * supported when ChromeDriver is running on Linux.<tr><td><a id="l679"></a><a href="#l679">679</a><td> * @param {string} path The directory path.<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @return {!Options} A self reference.<tr><td><a id="l681"></a><a href="#l681">681</a><td> */<tr><td><a id="l682"></a><a href="#l682">682</a><td>Options.prototype.setChromeMinidumpPath = function(path) {<tr><td><a id="l683"></a><a href="#l683">683</a><td> this.options_.minidumpPath = path;<tr><td><a id="l684"></a><a href="#l684">684</a><td> return this;<tr><td><a id="l685"></a><a href="#l685">685</a><td>};<tr><td><a id="l686"></a><a href="#l686">686</a><td><tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td>/**<tr><td><a id="l689"></a><a href="#l689">689</a><td> * Configures Chrome to emulate a mobile device. For more information, refer to<tr><td><a id="l690"></a><a href="#l690">690</a><td> * the ChromeDriver project page on [mobile emulation][em]. Configuration<tr><td><a id="l691"></a><a href="#l691">691</a><td> * options include:<tr><td><a id="l692"></a><a href="#l692">692</a><td> *<tr><td><a id="l693"></a><a href="#l693">693</a><td> * - `deviceName`: The name of a pre-configured [emulated device][devem]<tr><td><a id="l694"></a><a href="#l694">694</a><td> * - `width`: screen width, in pixels<tr><td><a id="l695"></a><a href="#l695">695</a><td> * - `height`: screen height, in pixels<tr><td><a id="l696"></a><a href="#l696">696</a><td> * - `pixelRatio`: screen pixel ratio<tr><td><a id="l697"></a><a href="#l697">697</a><td> *<tr><td><a id="l698"></a><a href="#l698">698</a><td> * __Example 1: Using a Pre-configured Device__<tr><td><a id="l699"></a><a href="#l699">699</a><td> *<tr><td><a id="l700"></a><a href="#l700">700</a><td> * var options = new chrome.Options().setMobileEmulation(<tr><td><a id="l701"></a><a href="#l701">701</a><td> * {deviceName: &#39;Google Nexus 5&#39;});<tr><td><a id="l702"></a><a href="#l702">702</a><td> *<tr><td><a id="l703"></a><a href="#l703">703</a><td> * var driver = new chrome.Driver(options);<tr><td><a id="l704"></a><a href="#l704">704</a><td> *<tr><td><a id="l705"></a><a href="#l705">705</a><td> * __Example 2: Using Custom Screen Configuration__<tr><td><a id="l706"></a><a href="#l706">706</a><td> *<tr><td><a id="l707"></a><a href="#l707">707</a><td> * var options = new chrome.Options().setMobileEmulation({<tr><td><a id="l708"></a><a href="#l708">708</a><td> * width: 360,<tr><td><a id="l709"></a><a href="#l709">709</a><td> * height: 640,<tr><td><a id="l710"></a><a href="#l710">710</a><td> * pixelRatio: 3.0<tr><td><a id="l711"></a><a href="#l711">711</a><td> * });<tr><td><a id="l712"></a><a href="#l712">712</a><td> *<tr><td><a id="l713"></a><a href="#l713">713</a><td> * var driver = new chrome.Driver(options);<tr><td><a id="l714"></a><a href="#l714">714</a><td> *<tr><td><a id="l715"></a><a href="#l715">715</a><td> *<tr><td><a id="l716"></a><a href="#l716">716</a><td> * [em]: https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation<tr><td><a id="l717"></a><a href="#l717">717</a><td> * [devem]: https://developer.chrome.com/devtools/docs/device-mode<tr><td><a id="l718"></a><a href="#l718">718</a><td> *<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @param {?({deviceName: string}|<tr><td><a id="l720"></a><a href="#l720">720</a><td> * {width: number, height: number, pixelRatio: number})} config The<tr><td><a id="l721"></a><a href="#l721">721</a><td> * mobile emulation configuration, or `null` to disable emulation.<tr><td><a id="l722"></a><a href="#l722">722</a><td> * @return {!Options} A self reference.<tr><td><a id="l723"></a><a href="#l723">723</a><td> */<tr><td><a id="l724"></a><a href="#l724">724</a><td>Options.prototype.setMobileEmulation = function(config) {<tr><td><a id="l725"></a><a href="#l725">725</a><td> this.options_.mobileEmulation = config;<tr><td><a id="l726"></a><a href="#l726">726</a><td> return this;<tr><td><a id="l727"></a><a href="#l727">727</a><td>};<tr><td><a id="l728"></a><a href="#l728">728</a><td><tr><td><a id="l729"></a><a href="#l729">729</a><td><tr><td><a id="l730"></a><a href="#l730">730</a><td>/**<tr><td><a id="l731"></a><a href="#l731">731</a><td> * Sets the proxy settings for the new session.<tr><td><a id="l732"></a><a href="#l732">732</a><td> * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l733"></a><a href="#l733">733</a><td> * @return {!Options} A self reference.<tr><td><a id="l734"></a><a href="#l734">734</a><td> */<tr><td><a id="l735"></a><a href="#l735">735</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l736"></a><a href="#l736">736</a><td> this.proxy_ = proxy;<tr><td><a id="l737"></a><a href="#l737">737</a><td> return this;<tr><td><a id="l738"></a><a href="#l738">738</a><td>};<tr><td><a id="l739"></a><a href="#l739">739</a><td><tr><td><a id="l740"></a><a href="#l740">740</a><td><tr><td><a id="l741"></a><a href="#l741">741</a><td>/**<tr><td><a id="l742"></a><a href="#l742">742</a><td> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l743"></a><a href="#l743">743</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l744"></a><a href="#l744">744</a><td> * these options into, if any.<tr><td><a id="l745"></a><a href="#l745">745</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a id="l746"></a><a href="#l746">746</a><td> */<tr><td><a id="l747"></a><a href="#l747">747</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l748"></a><a href="#l748">748</a><td> var capabilities = opt_capabilities || webdriver.Capabilities.chrome();<tr><td><a id="l749"></a><a href="#l749">749</a><td> capabilities.<tr><td><a id="l750"></a><a href="#l750">750</a><td> set(webdriver.Capability.PROXY, this.proxy_).<tr><td><a id="l751"></a><a href="#l751">751</a><td> set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).<tr><td><a id="l752"></a><a href="#l752">752</a><td> set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a id="l753"></a><a href="#l753">753</a><td> return capabilities;<tr><td><a id="l754"></a><a href="#l754">754</a><td>};<tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td><tr><td><a id="l757"></a><a href="#l757">757</a><td>/**<tr><td><a id="l758"></a><a href="#l758">758</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a id="l759"></a><a href="#l759">759</a><td> * function is an implementation not intended for general use.<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @return {{args: !Array.&lt;string&gt;,<tr><td><a id="l761"></a><a href="#l761">761</a><td> * binary: (string|undefined),<tr><td><a id="l762"></a><a href="#l762">762</a><td> * detach: boolean,<tr><td><a id="l763"></a><a href="#l763">763</a><td> * extensions: !Array.&lt;(string|!webdriver.promise.Promise.&lt;string&gt;)&gt;,<tr><td><a id="l764"></a><a href="#l764">764</a><td> * localState: (Object|undefined),<tr><td><a id="l765"></a><a href="#l765">765</a><td> * logPath: (string|undefined),<tr><td><a id="l766"></a><a href="#l766">766</a><td> * prefs: (Object|undefined)}} The JSON wire protocol representation<tr><td><a id="l767"></a><a href="#l767">767</a><td> * of this instance.<tr><td><a id="l768"></a><a href="#l768">768</a><td> * @override<tr><td><a id="l769"></a><a href="#l769">769</a><td> */<tr><td><a id="l770"></a><a href="#l770">770</a><td>Options.prototype.serialize = function() {<tr><td><a id="l771"></a><a href="#l771">771</a><td> var json = {};<tr><td><a id="l772"></a><a href="#l772">772</a><td> for (var key in this.options_) {<tr><td><a id="l773"></a><a href="#l773">773</a><td> if (this.options_[key] != null) {<tr><td><a id="l774"></a><a href="#l774">774</a><td> json[key] = this.options_[key];<tr><td><a id="l775"></a><a href="#l775">775</a><td> }<tr><td><a id="l776"></a><a href="#l776">776</a><td> }<tr><td><a id="l777"></a><a href="#l777">777</a><td> if (this.extensions_.length) {<tr><td><a id="l778"></a><a href="#l778">778</a><td> json.extensions = this.extensions_.map(function(extension) {<tr><td><a id="l779"></a><a href="#l779">779</a><td> if (Buffer.isBuffer(extension)) {<tr><td><a id="l780"></a><a href="#l780">780</a><td> return extension.toString(&#39;base64&#39;);<tr><td><a id="l781"></a><a href="#l781">781</a><td> }<tr><td><a id="l782"></a><a href="#l782">782</a><td> return webdriver.promise.checkedNodeCall(<tr><td><a id="l783"></a><a href="#l783">783</a><td> fs.readFile, extension, &#39;base64&#39;);<tr><td><a id="l784"></a><a href="#l784">784</a><td> });<tr><td><a id="l785"></a><a href="#l785">785</a><td> }<tr><td><a id="l786"></a><a href="#l786">786</a><td> return json;<tr><td><a id="l787"></a><a href="#l787">787</a><td>};<tr><td><a id="l788"></a><a href="#l788">788</a><td><tr><td><a id="l789"></a><a href="#l789">789</a><td><tr><td><a id="l790"></a><a href="#l790">790</a><td>/**<tr><td><a id="l791"></a><a href="#l791">791</a><td> * Creates a new WebDriver client for Chrome.<tr><td><a id="l792"></a><a href="#l792">792</a><td> *<tr><td><a id="l793"></a><a href="#l793">793</a><td> * @param {(webdriver.Capabilities|Options)=} opt_config The configuration<tr><td><a id="l794"></a><a href="#l794">794</a><td> * options.<tr><td><a id="l795"></a><a href="#l795">795</a><td> * @param {remote.DriverService=} opt_service The session to use; will use<tr><td><a id="l796"></a><a href="#l796">796</a><td> * the {@linkplain #getDefaultService default service} by default.<tr><td><a id="l797"></a><a href="#l797">797</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l798"></a><a href="#l798">798</a><td> * {@code null} to use the currently active flow.<tr><td><a id="l799"></a><a href="#l799">799</a><td> * @constructor<tr><td><a id="l800"></a><a href="#l800">800</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l801"></a><a href="#l801">801</a><td> */<tr><td><a id="l802"></a><a href="#l802">802</a><td>var Driver = function(opt_config, opt_service, opt_flow) {<tr><td><a id="l803"></a><a href="#l803">803</a><td> var service = opt_service || getDefaultService();<tr><td><a id="l804"></a><a href="#l804">804</a><td> var executor = createExecutor(service.start());<tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td> var capabilities =<tr><td><a id="l807"></a><a href="#l807">807</a><td> opt_config instanceof Options ? opt_config.toCapabilities() :<tr><td><a id="l808"></a><a href="#l808">808</a><td> (opt_config || webdriver.Capabilities.chrome());<tr><td><a id="l809"></a><a href="#l809">809</a><td><tr><td><a id="l810"></a><a href="#l810">810</a><td> var driver = webdriver.WebDriver.createSession(<tr><td><a id="l811"></a><a href="#l811">811</a><td> executor, capabilities, opt_flow);<tr><td><a id="l812"></a><a href="#l812">812</a><td><tr><td><a id="l813"></a><a href="#l813">813</a><td> webdriver.WebDriver.call(<tr><td><a id="l814"></a><a href="#l814">814</a><td> this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l815"></a><a href="#l815">815</a><td>};<tr><td><a id="l816"></a><a href="#l816">816</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l817"></a><a href="#l817">817</a><td><tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td>/**<tr><td><a id="l820"></a><a href="#l820">820</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l821"></a><a href="#l821">821</a><td> * implementation.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @override<tr><td><a id="l823"></a><a href="#l823">823</a><td> */<tr><td><a id="l824"></a><a href="#l824">824</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l825"></a><a href="#l825">825</a><td>};<tr><td><a id="l826"></a><a href="#l826">826</a><td><tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td>/**<tr><td><a id="l829"></a><a href="#l829">829</a><td> * Schedules a command to launch Chrome App with given ID.<tr><td><a id="l830"></a><a href="#l830">830</a><td> * @param {string} id ID of the App to launch.<tr><td><a id="l831"></a><a href="#l831">831</a><td> * @return {!webdriver.promise.Promise&lt;void&gt;} A promise that will be resolved<tr><td><a id="l832"></a><a href="#l832">832</a><td> * when app is launched.<tr><td><a id="l833"></a><a href="#l833">833</a><td> */<tr><td><a id="l834"></a><a href="#l834">834</a><td>Driver.prototype.launchApp = function(id) {<tr><td><a id="l835"></a><a href="#l835">835</a><td> return this.schedule(<tr><td><a id="l836"></a><a href="#l836">836</a><td> new webdriver.Command(Command.LAUNCH_APP).setParameter(&#39;id&#39;, id),<tr><td><a id="l837"></a><a href="#l837">837</a><td> &#39;Driver.launchApp()&#39;);<tr><td><a id="l838"></a><a href="#l838">838</a><td>};<tr><td><a id="l839"></a><a href="#l839">839</a><td><tr><td><a id="l840"></a><a href="#l840">840</a><td><tr><td><a id="l841"></a><a href="#l841">841</a><td>// PUBLIC API<tr><td><a id="l842"></a><a href="#l842">842</a><td><tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td>exports.Driver = Driver;<tr><td><a id="l845"></a><a href="#l845">845</a><td>exports.Options = Options;<tr><td><a id="l846"></a><a href="#l846">846</a><td>exports.ServiceBuilder = ServiceBuilder;<tr><td><a id="l847"></a><a href="#l847">847</a><td>exports.getDefaultService = getDefaultService;<tr><td><a id="l848"></a><a href="#l848">848</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/error.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>error.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>error.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 base = require(&#39;./_base&#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>/** @type {function(new: bot.Error)} */<tr><td><a id="l24"></a><a href="#l24">24</a><td>exports.Error = base.require(&#39;bot.Error&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>/** @type {bot.ErrorCode.} */<tr><td><a id="l27"></a><a href="#l27">27</a><td>exports.ErrorCode = base.require(&#39;bot.ErrorCode&#39;);</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/executors.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>executors.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>executors.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 Various utilities for working with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * {@link webdriver.CommandExecutor} implementations.<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>var HttpClient = require(&#39;./http&#39;).HttpClient,<tr><td><a id="l24"></a><a href="#l24">24</a><td> HttpExecutor = require(&#39;./http&#39;).Executor,<tr><td><a id="l25"></a><a href="#l25">25</a><td> promise = require(&#39;./_base&#39;).require(&#39;webdriver.promise&#39;);<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><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Wraps a promised {@link webdriver.CommandExecutor}, ensuring no commands<tr><td><a id="l31"></a><a href="#l31">31</a><td> * are executed until the wrapped executor has been fully built.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {!webdriver.promise.Promise.&lt;!webdriver.CommandExecutor&gt;} delegate The<tr><td><a id="l33"></a><a href="#l33">33</a><td> * promised delegate.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @constructor<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>var DeferredExecutor = function(delegate) {<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td> /** @override */<tr><td><a id="l40"></a><a href="#l40">40</a><td> this.execute = function(command, callback) {<tr><td><a id="l41"></a><a href="#l41">41</a><td> delegate.then(function(executor) {<tr><td><a id="l42"></a><a href="#l42">42</a><td> executor.execute(command, callback);<tr><td><a id="l43"></a><a href="#l43">43</a><td> }, callback);<tr><td><a id="l44"></a><a href="#l44">44</a><td> };<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>// PUBLIC API<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>exports.DeferredExecutor = DeferredExecutor;<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Creates a command executor that uses WebDriver&#39;s JSON wire protocol.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {(string|!webdriver.promise.Promise.&lt;string&gt;)} url The server&#39;s URL,<tr><td><a id="l56"></a><a href="#l56">56</a><td> * or a promise that will resolve to that URL.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {string=} opt_proxy (optional) The URL of the HTTP proxy for the<tr><td><a id="l58"></a><a href="#l58">58</a><td> * client to use.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @returns {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>exports.createExecutor = function(url, opt_proxy) {<tr><td><a id="l62"></a><a href="#l62">62</a><td> return new DeferredExecutor(promise.when(url, function(url) {<tr><td><a id="l63"></a><a href="#l63">63</a><td> var client = new HttpClient(url, null, opt_proxy);<tr><td><a id="l64"></a><a href="#l64">64</a><td> return new HttpExecutor(client);<tr><td><a id="l65"></a><a href="#l65">65</a><td> }));<tr><td><a id="l66"></a><a href="#l66">66</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/firefox/binary.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>binary.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>firefox/binary.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 Manages Firefox binaries. This module is considered internal;<tr><td><a id="l20"></a><a href="#l20">20</a><td> * users should use {@link selenium-webdriver/firefox}.<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>&#39;use strict&#39;;<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>var child = require(&#39;child_process&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td> fs = require(&#39;fs&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td> path = require(&#39;path&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td> util = require(&#39;util&#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>var Serializable = require(&#39;..&#39;).Serializable,<tr><td><a id="l31"></a><a href="#l31">31</a><td> promise = require(&#39;..&#39;).promise,<tr><td><a id="l32"></a><a href="#l32">32</a><td> _base = require(&#39;../_base&#39;),<tr><td><a id="l33"></a><a href="#l33">33</a><td> io = require(&#39;../io&#39;),<tr><td><a id="l34"></a><a href="#l34">34</a><td> exec = require(&#39;../io/exec&#39;);<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><tr><td><a id="l38"></a><a href="#l38">38</a><td>/** @const */<tr><td><a id="l39"></a><a href="#l39">39</a><td>var NO_FOCUS_LIB_X86 = _base.isDevMode() ?<tr><td><a id="l40"></a><a href="#l40">40</a><td> path.join(__dirname, &#39;../../../../cpp/prebuilt/i386/libnoblur.so&#39;) :<tr><td><a id="l41"></a><a href="#l41">41</a><td> path.join(__dirname, &#39;../lib/firefox/i386/libnoblur.so&#39;) ;<tr><td><a id="l42"></a><a href="#l42">42</a><td><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>var NO_FOCUS_LIB_AMD64 = _base.isDevMode() ?<tr><td><a id="l45"></a><a href="#l45">45</a><td> path.join(__dirname, &#39;../../../../cpp/prebuilt/amd64/libnoblur64.so&#39;) :<tr><td><a id="l46"></a><a href="#l46">46</a><td> path.join(__dirname, &#39;../lib/firefox/amd64/libnoblur64.so&#39;) ;<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>var X_IGNORE_NO_FOCUS_LIB = &#39;x_ignore_nofocus.so&#39;;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>var foundBinary = null;<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Checks the default Windows Firefox locations in Program Files.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @return {!promise.Promise.&lt;?string&gt;} A promise for the located executable.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * The promise will resolve to {@code null} if Fireox was not found.<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>function defaultWindowsLocation() {<tr><td><a id="l59"></a><a href="#l59">59</a><td> var files = [<tr><td><a id="l60"></a><a href="#l60">60</a><td> process.env[&#39;PROGRAMFILES&#39;] || &#39;C:\\Program Files&#39;,<tr><td><a id="l61"></a><a href="#l61">61</a><td> process.env[&#39;PROGRAMFILES(X86)&#39;] || &#39;C:\\Program Files (x86)&#39;<tr><td><a id="l62"></a><a href="#l62">62</a><td> ].map(function(prefix) {<tr><td><a id="l63"></a><a href="#l63">63</a><td> return path.join(prefix, &#39;Mozilla Firefox\\firefox.exe&#39;);<tr><td><a id="l64"></a><a href="#l64">64</a><td> });<tr><td><a id="l65"></a><a href="#l65">65</a><td> return io.exists(files[0]).then(function(exists) {<tr><td><a id="l66"></a><a href="#l66">66</a><td> return exists ? files[0] : io.exists(files[1]).then(function(exists) {<tr><td><a id="l67"></a><a href="#l67">67</a><td> return exists ? files[1] : null;<tr><td><a id="l68"></a><a href="#l68">68</a><td> });<tr><td><a id="l69"></a><a href="#l69">69</a><td> });<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> * Locates the Firefox binary for the current system.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the located binary. The<tr><td><a id="l76"></a><a href="#l76">76</a><td> * promise will be rejected if Firefox cannot be located.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>function findFirefox() {<tr><td><a id="l79"></a><a href="#l79">79</a><td> if (foundBinary) {<tr><td><a id="l80"></a><a href="#l80">80</a><td> return foundBinary;<tr><td><a id="l81"></a><a href="#l81">81</a><td> }<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td> if (process.platform === &#39;darwin&#39;) {<tr><td><a id="l84"></a><a href="#l84">84</a><td> var osxExe = &#39;/Applications/Firefox.app/Contents/MacOS/firefox-bin&#39;;<tr><td><a id="l85"></a><a href="#l85">85</a><td> foundBinary = io.exists(osxExe).then(function(exists) {<tr><td><a id="l86"></a><a href="#l86">86</a><td> return exists ? osxExe : null;<tr><td><a id="l87"></a><a href="#l87">87</a><td> });<tr><td><a id="l88"></a><a href="#l88">88</a><td> } else if (process.platform === &#39;win32&#39;) {<tr><td><a id="l89"></a><a href="#l89">89</a><td> foundBinary = defaultWindowsLocation();<tr><td><a id="l90"></a><a href="#l90">90</a><td> } else {<tr><td><a id="l91"></a><a href="#l91">91</a><td> foundBinary = promise.fulfilled(io.findInPath(&#39;firefox&#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> return foundBinary = foundBinary.then(function(found) {<tr><td><a id="l95"></a><a href="#l95">95</a><td> if (found) {<tr><td><a id="l96"></a><a href="#l96">96</a><td> return found;<tr><td><a id="l97"></a><a href="#l97">97</a><td> }<tr><td><a id="l98"></a><a href="#l98">98</a><td> throw Error(&#39;Could not locate Firefox on the current system&#39;);<tr><td><a id="l99"></a><a href="#l99">99</a><td> });<tr><td><a id="l100"></a><a href="#l100">100</a><td>}<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Copies the no focus libs into the given profile directory.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string} profileDir Path to the profile directory to install into.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!promise.Promise.&lt;string&gt;} The LD_LIBRARY_PATH prefix string to use<tr><td><a id="l107"></a><a href="#l107">107</a><td> * for the installed libs.<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>function installNoFocusLibs(profileDir) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> var x86 = path.join(profileDir, &#39;x86&#39;);<tr><td><a id="l111"></a><a href="#l111">111</a><td> var amd64 = path.join(profileDir, &#39;amd64&#39;);<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td> return mkdir(x86)<tr><td><a id="l114"></a><a href="#l114">114</a><td> .then(copyLib.bind(null, NO_FOCUS_LIB_X86, x86))<tr><td><a id="l115"></a><a href="#l115">115</a><td> .then(mkdir.bind(null, amd64))<tr><td><a id="l116"></a><a href="#l116">116</a><td> .then(copyLib.bind(null, NO_FOCUS_LIB_AMD64, amd64))<tr><td><a id="l117"></a><a href="#l117">117</a><td> .then(function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td> return x86 + &#39;:&#39; + amd64;<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> function mkdir(dir) {<tr><td><a id="l122"></a><a href="#l122">122</a><td> return io.exists(dir).then(function(exists) {<tr><td><a id="l123"></a><a href="#l123">123</a><td> if (!exists) {<tr><td><a id="l124"></a><a href="#l124">124</a><td> return promise.checkedNodeCall(fs.mkdir, dir);<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> }<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td> function copyLib(src, dir) {<tr><td><a id="l130"></a><a href="#l130">130</a><td> return io.copy(src, path.join(dir, X_IGNORE_NO_FOCUS_LIB));<tr><td><a id="l131"></a><a href="#l131">131</a><td> }<tr><td><a id="l132"></a><a href="#l132">132</a><td>}<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Manages a Firefox subprocess configured for use with WebDriver.<tr><td><a id="l137"></a><a href="#l137">137</a><td> *<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {string=} opt_exe Path to the Firefox binary to use. If not<tr><td><a id="l139"></a><a href="#l139">139</a><td> * specified, will attempt to locate Firefox on the current system.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @constructor<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @extends {Serializable.&lt;string&gt;}<tr><td><a id="l142"></a><a href="#l142">142</a><td> */<tr><td><a id="l143"></a><a href="#l143">143</a><td>var Binary = function(opt_exe) {<tr><td><a id="l144"></a><a href="#l144">144</a><td> Serializable.call(this);<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td> /** @private {(string|undefined)} */<tr><td><a id="l147"></a><a href="#l147">147</a><td> this.exe_ = opt_exe;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td> /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l150"></a><a href="#l150">150</a><td> this.args_ = [];<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td> /** @private {!Object.&lt;string, string&gt;} */<tr><td><a id="l153"></a><a href="#l153">153</a><td> this.env_ = {};<tr><td><a id="l154"></a><a href="#l154">154</a><td> Object.keys(process.env).forEach(function(key) {<tr><td><a id="l155"></a><a href="#l155">155</a><td> this.env_[key] = process.env[key];<tr><td><a id="l156"></a><a href="#l156">156</a><td> }.bind(this));<tr><td><a id="l157"></a><a href="#l157">157</a><td> this.env_[&#39;MOZ_CRASHREPORTER_DISABLE&#39;] = &#39;1&#39;;<tr><td><a id="l158"></a><a href="#l158">158</a><td> this.env_[&#39;MOZ_NO_REMOTE&#39;] = &#39;1&#39;;<tr><td><a id="l159"></a><a href="#l159">159</a><td> this.env_[&#39;NO_EM_RESTART&#39;] = &#39;1&#39;;<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td> /** @private {promise.Promise.&lt;!exec.Command&gt;} */<tr><td><a id="l162"></a><a href="#l162">162</a><td> this.command_ = null;<tr><td><a id="l163"></a><a href="#l163">163</a><td>};<tr><td><a id="l164"></a><a href="#l164">164</a><td>util.inherits(Binary, Serializable);<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>/**<tr><td><a id="l168"></a><a href="#l168">168</a><td> * Add arguments to the command line used to start Firefox.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args Either the arguments to add as<tr><td><a id="l170"></a><a href="#l170">170</a><td> * varargs, or the arguments as an array.<tr><td><a id="l171"></a><a href="#l171">171</a><td> */<tr><td><a id="l172"></a><a href="#l172">172</a><td>Binary.prototype.addArguments = function(var_args) {<tr><td><a id="l173"></a><a href="#l173">173</a><td> for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> if (util.isArray(arguments[i])) {<tr><td><a id="l175"></a><a href="#l175">175</a><td> this.args_ = this.args_.concat(arguments[i]);<tr><td><a id="l176"></a><a href="#l176">176</a><td> } else {<tr><td><a id="l177"></a><a href="#l177">177</a><td> this.args_.push(arguments[i]);<tr><td><a id="l178"></a><a href="#l178">178</a><td> }<tr><td><a id="l179"></a><a href="#l179">179</a><td> }<tr><td><a id="l180"></a><a href="#l180">180</a><td>};<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Launches Firefox and eturns a promise that will be fulfilled when the process<tr><td><a id="l185"></a><a href="#l185">185</a><td> * terminates.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {string} profile Path to the profile directory to use.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {!promise.Promise.&lt;!exec.Result&gt;} A promise for the process result.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @throws {Error} If this instance has already been started.<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>Binary.prototype.launch = function(profile) {<tr><td><a id="l191"></a><a href="#l191">191</a><td> if (this.command_) {<tr><td><a id="l192"></a><a href="#l192">192</a><td> throw Error(&#39;Firefox is already running&#39;);<tr><td><a id="l193"></a><a href="#l193">193</a><td> }<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td> var env = {};<tr><td><a id="l196"></a><a href="#l196">196</a><td> Object.keys(this.env_).forEach(function(key) {<tr><td><a id="l197"></a><a href="#l197">197</a><td> env[key] = this.env_[key];<tr><td><a id="l198"></a><a href="#l198">198</a><td> }.bind(this));<tr><td><a id="l199"></a><a href="#l199">199</a><td> env[&#39;XRE_PROFILE_PATH&#39;] = profile;<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td> var args = [&#39;-foreground&#39;].concat(this.args_);<tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td> this.command_ = promise.when(this.exe_ || findFirefox(), function(firefox) {<tr><td><a id="l204"></a><a href="#l204">204</a><td> if (process.platform === &#39;win32&#39; || process.platform === &#39;darwin&#39;) {<tr><td><a id="l205"></a><a href="#l205">205</a><td> return exec(firefox, {args: args, env: env});<tr><td><a id="l206"></a><a href="#l206">206</a><td> }<tr><td><a id="l207"></a><a href="#l207">207</a><td> return installNoFocusLibs(profile).then(function(ldLibraryPath) {<tr><td><a id="l208"></a><a href="#l208">208</a><td> env[&#39;LD_LIBRARY_PATH&#39;] = ldLibraryPath + &#39;:&#39; + env[&#39;LD_LIBRARY_PATH&#39;];<tr><td><a id="l209"></a><a href="#l209">209</a><td> env[&#39;LD_PRELOAD&#39;] = X_IGNORE_NO_FOCUS_LIB;<tr><td><a id="l210"></a><a href="#l210">210</a><td> return exec(firefox, {args: args, env: env});<tr><td><a id="l211"></a><a href="#l211">211</a><td> });<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> return this.command_.then(function() {<tr><td><a id="l215"></a><a href="#l215">215</a><td> // Don&#39;t return the actual command handle, just a promise to signal it has<tr><td><a id="l216"></a><a href="#l216">216</a><td> // been started.<tr><td><a id="l217"></a><a href="#l217">217</a><td> });<tr><td><a id="l218"></a><a href="#l218">218</a><td>};<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Kills the managed Firefox process.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!promise.Promise} A promise for when the process has terminated.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>Binary.prototype.kill = function() {<tr><td><a id="l226"></a><a href="#l226">226</a><td> if (!this.command_) {<tr><td><a id="l227"></a><a href="#l227">227</a><td> return promise.defer(); // Not running.<tr><td><a id="l228"></a><a href="#l228">228</a><td> }<tr><td><a id="l229"></a><a href="#l229">229</a><td> return this.command_.then(function(command) {<tr><td><a id="l230"></a><a href="#l230">230</a><td> command.kill();<tr><td><a id="l231"></a><a href="#l231">231</a><td> return command.result();<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><tr><td><a id="l235"></a><a href="#l235">235</a><td><tr><td><a id="l236"></a><a href="#l236">236</a><td>/**<tr><td><a id="l237"></a><a href="#l237">237</a><td> * Returns a promise for the wire representation of this binary. Note: the<tr><td><a id="l238"></a><a href="#l238">238</a><td> * FirefoxDriver only supports passing the path to the binary executable over<tr><td><a id="l239"></a><a href="#l239">239</a><td> * the wire; all command line arguments and environment variables will be<tr><td><a id="l240"></a><a href="#l240">240</a><td> * discarded.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for this binary&#39;s wire<tr><td><a id="l243"></a><a href="#l243">243</a><td> * representation.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @override<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>Binary.prototype.serialize = function() {<tr><td><a id="l247"></a><a href="#l247">247</a><td> return promise.when(this.exe_ || findFirefox());<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>// PUBLIC API<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>exports.Binary = Binary;<tr><td><a id="l255"></a><a href="#l255">255</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/firefox/extension.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>extension.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>firefox/extension.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>/** @fileoverview Utilities for working with Firefox extensions. */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>&#39;use strict&#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>var AdmZip = require(&#39;adm-zip&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td> fs = require(&#39;fs&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td> path = require(&#39;path&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td> util = require(&#39;util&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td> xml = require(&#39;xml2js&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>var promise = require(&#39;..&#39;).promise,<tr><td><a id="l29"></a><a href="#l29">29</a><td> checkedCall = promise.checkedNodeCall,<tr><td><a id="l30"></a><a href="#l30">30</a><td> io = require(&#39;../io&#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><tr><td><a id="l33"></a><a href="#l33">33</a><td>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Thrown when there an add-on is malformed.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {string} msg The error message.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @extends {Error}<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>function AddonFormatError(msg) {<tr><td><a id="l40"></a><a href="#l40">40</a><td> Error.call(this);<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td> Error.captureStackTrace(this, AddonFormatError);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td> /** @override */<tr><td><a id="l45"></a><a href="#l45">45</a><td> this.name = AddonFormatError.name;<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td> /** @override */<tr><td><a id="l48"></a><a href="#l48">48</a><td> this.message = msg;<tr><td><a id="l49"></a><a href="#l49">49</a><td>}<tr><td><a id="l50"></a><a href="#l50">50</a><td>util.inherits(AddonFormatError, Error);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Installs an extension to the given directory.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {string} extension Path to the extension to install, as either a xpi<tr><td><a id="l57"></a><a href="#l57">57</a><td> * file or a directory.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} dir Path to the directory to install the extension in.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the add-on ID once<tr><td><a id="l60"></a><a href="#l60">60</a><td> * installed.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>function install(extension, dir) {<tr><td><a id="l63"></a><a href="#l63">63</a><td> return getDetails(extension).then(function(details) {<tr><td><a id="l64"></a><a href="#l64">64</a><td> function returnId() { return details.id; }<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td> var dst = path.join(dir, details.id);<tr><td><a id="l67"></a><a href="#l67">67</a><td> if (extension.slice(-4) === &#39;.xpi&#39;) {<tr><td><a id="l68"></a><a href="#l68">68</a><td> if (!details.unpack) {<tr><td><a id="l69"></a><a href="#l69">69</a><td> return io.copy(extension, dst + &#39;.xpi&#39;).then(returnId);<tr><td><a id="l70"></a><a href="#l70">70</a><td> } else {<tr><td><a id="l71"></a><a href="#l71">71</a><td> return checkedCall(fs.readFile, extension).then(function(buff) {<tr><td><a id="l72"></a><a href="#l72">72</a><td> var zip = new AdmZip(buff);<tr><td><a id="l73"></a><a href="#l73">73</a><td> // TODO: find an async library for inflating a zip archive.<tr><td><a id="l74"></a><a href="#l74">74</a><td> new AdmZip(buff).extractAllTo(dst, true);<tr><td><a id="l75"></a><a href="#l75">75</a><td> }).then(returnId);<tr><td><a id="l76"></a><a href="#l76">76</a><td> }<tr><td><a id="l77"></a><a href="#l77">77</a><td> } else {<tr><td><a id="l78"></a><a href="#l78">78</a><td> return io.copyDir(extension, dst).then(returnId);<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><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> * Describes a Firefox add-on.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @typedef {{id: string, name: string, version: string, unpack: boolean}}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>var AddonDetails;<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td>/**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * Extracts the details needed to install an add-on.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {string} addonPath Path to the extension directory.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @return {!promise.Promise.&lt;!AddonDetails&gt;} A promise for the add-on details.<tr><td><a id="l95"></a><a href="#l95">95</a><td> */<tr><td><a id="l96"></a><a href="#l96">96</a><td>function getDetails(addonPath) {<tr><td><a id="l97"></a><a href="#l97">97</a><td> return readManifest(addonPath).then(function(doc) {<tr><td><a id="l98"></a><a href="#l98">98</a><td> var em = getNamespaceId(doc, &#39;http://www.mozilla.org/2004/em-rdf#&#39;);<tr><td><a id="l99"></a><a href="#l99">99</a><td> var rdf = getNamespaceId(<tr><td><a id="l100"></a><a href="#l100">100</a><td> doc, &#39;http://www.w3.org/1999/02/22-rdf-syntax-ns#&#39;);<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 description = doc[rdf + &#39;RDF&#39;][rdf + &#39;Description&#39;][0];<tr><td><a id="l103"></a><a href="#l103">103</a><td> var details = {<tr><td><a id="l104"></a><a href="#l104">104</a><td> id: getNodeText(description, em + &#39;id&#39;),<tr><td><a id="l105"></a><a href="#l105">105</a><td> name: getNodeText(description, em + &#39;name&#39;),<tr><td><a id="l106"></a><a href="#l106">106</a><td> version: getNodeText(description, em + &#39;version&#39;),<tr><td><a id="l107"></a><a href="#l107">107</a><td> unpack: getNodeText(description, em + &#39;unpack&#39;) || false<tr><td><a id="l108"></a><a href="#l108">108</a><td> };<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td> if (typeof details.unpack === &#39;string&#39;) {<tr><td><a id="l111"></a><a href="#l111">111</a><td> details.unpack = details.unpack.toLowerCase() === &#39;true&#39;;<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> if (!details.id) {<tr><td><a id="l115"></a><a href="#l115">115</a><td> throw new AddonFormatError(&#39;Could not find add-on ID for &#39; + addonPath);<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td> return details;<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> function getNodeText(node, name) {<tr><td><a id="l122"></a><a href="#l122">122</a><td> return node[name] &amp;&amp; node[name][0] || &#39;&#39;;<tr><td><a id="l123"></a><a href="#l123">123</a><td> }<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td> function getNamespaceId(doc, url) {<tr><td><a id="l126"></a><a href="#l126">126</a><td> var keys = Object.keys(doc);<tr><td><a id="l127"></a><a href="#l127">127</a><td> if (keys.length !== 1) {<tr><td><a id="l128"></a><a href="#l128">128</a><td> throw new AddonFormatError(&#39;Malformed manifest for add-on &#39; + addonPath);<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> var namespaces = doc[keys[0]].$;<tr><td><a id="l132"></a><a href="#l132">132</a><td> var id = &#39;&#39;;<tr><td><a id="l133"></a><a href="#l133">133</a><td> Object.keys(namespaces).some(function(ns) {<tr><td><a id="l134"></a><a href="#l134">134</a><td> if (namespaces[ns] !== url) {<tr><td><a id="l135"></a><a href="#l135">135</a><td> return false;<tr><td><a id="l136"></a><a href="#l136">136</a><td> }<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td> if (ns.indexOf(&#39;:&#39;) != -1) {<tr><td><a id="l139"></a><a href="#l139">139</a><td> id = ns.split(&#39;:&#39;)[1] + &#39;:&#39;;<tr><td><a id="l140"></a><a href="#l140">140</a><td> }<tr><td><a id="l141"></a><a href="#l141">141</a><td> return true;<tr><td><a id="l142"></a><a href="#l142">142</a><td> });<tr><td><a id="l143"></a><a href="#l143">143</a><td> return id;<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><tr><td><a id="l148"></a><a href="#l148">148</a><td>/**<tr><td><a id="l149"></a><a href="#l149">149</a><td> * Reads the manifest for a Firefox add-on.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {string} addonPath Path to a Firefox add-on as a xpi or an extension.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {!promise.Promise.&lt;!Object&gt;} A promise for the parsed manifest.<tr><td><a id="l152"></a><a href="#l152">152</a><td> */<tr><td><a id="l153"></a><a href="#l153">153</a><td>function readManifest(addonPath) {<tr><td><a id="l154"></a><a href="#l154">154</a><td> var manifest;<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td> if (addonPath.slice(-4) === &#39;.xpi&#39;) {<tr><td><a id="l157"></a><a href="#l157">157</a><td> manifest = checkedCall(fs.readFile, addonPath).then(function(buff) {<tr><td><a id="l158"></a><a href="#l158">158</a><td> var zip = new AdmZip(buff);<tr><td><a id="l159"></a><a href="#l159">159</a><td> if (!zip.getEntry(&#39;install.rdf&#39;)) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> throw new AddonFormatError(<tr><td><a id="l161"></a><a href="#l161">161</a><td> &#39;Could not find install.rdf in &#39; + addonPath);<tr><td><a id="l162"></a><a href="#l162">162</a><td> }<tr><td><a id="l163"></a><a href="#l163">163</a><td> var done = promise.defer();<tr><td><a id="l164"></a><a href="#l164">164</a><td> zip.readAsTextAsync(&#39;install.rdf&#39;, done.fulfill);<tr><td><a id="l165"></a><a href="#l165">165</a><td> return done.promise;<tr><td><a id="l166"></a><a href="#l166">166</a><td> });<tr><td><a id="l167"></a><a href="#l167">167</a><td> } else {<tr><td><a id="l168"></a><a href="#l168">168</a><td> manifest = checkedCall(fs.stat, addonPath).then(function(stats) {<tr><td><a id="l169"></a><a href="#l169">169</a><td> if (!stats.isDirectory()) {<tr><td><a id="l170"></a><a href="#l170">170</a><td> throw Error(<tr><td><a id="l171"></a><a href="#l171">171</a><td> &#39;Add-on path is niether a xpi nor a directory: &#39; + addonPath);<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 checkedCall(fs.readFile, path.join(addonPath, &#39;install.rdf&#39;));<tr><td><a id="l174"></a><a href="#l174">174</a><td> });<tr><td><a id="l175"></a><a href="#l175">175</a><td> }<tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td> return manifest.then(function(content) {<tr><td><a id="l178"></a><a href="#l178">178</a><td> return checkedCall(xml.parseString, content);<tr><td><a id="l179"></a><a href="#l179">179</a><td> });<tr><td><a id="l180"></a><a href="#l180">180</a><td>}<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>// PUBLIC API<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>exports.install = install;</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>