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/lib/webdriver/command.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>command.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>lib/webdriver/command.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 Contains several classes for handling commands.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.Command&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.CommandExecutor&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.CommandName&#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><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> * Describes a command to be executed by the WebDriverJS framework.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {!webdriver.CommandName} name The name of this command.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @constructor<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>webdriver.Command = function(name) {<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td> /**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * The name of this command.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @private {!webdriver.CommandName}<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td> this.name_ = name;<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td> /**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * The parameters to this command.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @private {!Object.&lt;*&gt;}<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td> this.parameters_ = {};<tr><td><a id="l46"></a><a href="#l46">46</a><td>};<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {!webdriver.CommandName} This command&#39;s name.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>webdriver.Command.prototype.getName = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td> return this.name_;<tr><td><a id="l54"></a><a href="#l54">54</a><td>};<tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Sets a parameter to send with this command.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string} name The parameter name.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {*} value The parameter value.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>webdriver.Command.prototype.setParameter = function(name, value) {<tr><td><a id="l64"></a><a href="#l64">64</a><td> this.parameters_[name] = value;<tr><td><a id="l65"></a><a href="#l65">65</a><td> return this;<tr><td><a id="l66"></a><a href="#l66">66</a><td>};<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Sets the parameters for this command.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {!Object.&lt;*&gt;} parameters The command parameters.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>webdriver.Command.prototype.setParameters = function(parameters) {<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.parameters_ = parameters;<tr><td><a id="l76"></a><a href="#l76">76</a><td> return this;<tr><td><a id="l77"></a><a href="#l77">77</a><td>};<tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td>/**<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Returns a named command parameter.<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @param {string} key The parameter key to look up.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @return {*} The parameter value, or undefined if it has not been set.<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td>webdriver.Command.prototype.getParameter = function(key) {<tr><td><a id="l86"></a><a href="#l86">86</a><td> return this.parameters_[key];<tr><td><a id="l87"></a><a href="#l87">87</a><td>};<tr><td><a id="l88"></a><a href="#l88">88</a><td><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> * @return {!Object.&lt;*&gt;} The parameters to send with this command.<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>webdriver.Command.prototype.getParameters = function() {<tr><td><a id="l94"></a><a href="#l94">94</a><td> return this.parameters_;<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * Enumeration of predefined names command names that all command processors<tr><td><a id="l100"></a><a href="#l100">100</a><td> * will support.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @enum {string}<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>// TODO: Delete obsolete command names.<tr><td><a id="l104"></a><a href="#l104">104</a><td>webdriver.CommandName = {<tr><td><a id="l105"></a><a href="#l105">105</a><td> GET_SERVER_STATUS: &#39;getStatus&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td> NEW_SESSION: &#39;newSession&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td> GET_SESSIONS: &#39;getSessions&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td> DESCRIBE_SESSION: &#39;getSessionCapabilities&#39;,<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td> CLOSE: &#39;close&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td> QUIT: &#39;quit&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td> GET_CURRENT_URL: &#39;getCurrentUrl&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td> GET: &#39;get&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td> GO_BACK: &#39;goBack&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td> GO_FORWARD: &#39;goForward&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td> REFRESH: &#39;refresh&#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> ADD_COOKIE: &#39;addCookie&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td> GET_COOKIE: &#39;getCookie&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td> GET_ALL_COOKIES: &#39;getCookies&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td> DELETE_COOKIE: &#39;deleteCookie&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td> DELETE_ALL_COOKIES: &#39;deleteAllCookies&#39;,<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td> GET_ACTIVE_ELEMENT: &#39;getActiveElement&#39;,<tr><td><a id="l127"></a><a href="#l127">127</a><td> FIND_ELEMENT: &#39;findElement&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td> FIND_ELEMENTS: &#39;findElements&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td> FIND_CHILD_ELEMENT: &#39;findChildElement&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td> FIND_CHILD_ELEMENTS: &#39;findChildElements&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td> CLEAR_ELEMENT: &#39;clearElement&#39;,<tr><td><a id="l133"></a><a href="#l133">133</a><td> CLICK_ELEMENT: &#39;clickElement&#39;,<tr><td><a id="l134"></a><a href="#l134">134</a><td> SEND_KEYS_TO_ELEMENT: &#39;sendKeysToElement&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td> SUBMIT_ELEMENT: &#39;submitElement&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td> GET_CURRENT_WINDOW_HANDLE: &#39;getCurrentWindowHandle&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td> GET_WINDOW_HANDLES: &#39;getWindowHandles&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td> GET_WINDOW_POSITION: &#39;getWindowPosition&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td> SET_WINDOW_POSITION: &#39;setWindowPosition&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td> GET_WINDOW_SIZE: &#39;getWindowSize&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td> SET_WINDOW_SIZE: &#39;setWindowSize&#39;,<tr><td><a id="l143"></a><a href="#l143">143</a><td> MAXIMIZE_WINDOW: &#39;maximizeWindow&#39;,<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td> SWITCH_TO_WINDOW: &#39;switchToWindow&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td> SWITCH_TO_FRAME: &#39;switchToFrame&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td> GET_PAGE_SOURCE: &#39;getPageSource&#39;,<tr><td><a id="l148"></a><a href="#l148">148</a><td> GET_TITLE: &#39;getTitle&#39;,<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td> EXECUTE_SCRIPT: &#39;executeScript&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td> EXECUTE_ASYNC_SCRIPT: &#39;executeAsyncScript&#39;,<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td> GET_ELEMENT_TEXT: &#39;getElementText&#39;,<tr><td><a id="l154"></a><a href="#l154">154</a><td> GET_ELEMENT_TAG_NAME: &#39;getElementTagName&#39;,<tr><td><a id="l155"></a><a href="#l155">155</a><td> IS_ELEMENT_SELECTED: &#39;isElementSelected&#39;,<tr><td><a id="l156"></a><a href="#l156">156</a><td> IS_ELEMENT_ENABLED: &#39;isElementEnabled&#39;,<tr><td><a id="l157"></a><a href="#l157">157</a><td> IS_ELEMENT_DISPLAYED: &#39;isElementDisplayed&#39;,<tr><td><a id="l158"></a><a href="#l158">158</a><td> GET_ELEMENT_LOCATION: &#39;getElementLocation&#39;,<tr><td><a id="l159"></a><a href="#l159">159</a><td> GET_ELEMENT_LOCATION_IN_VIEW: &#39;getElementLocationOnceScrolledIntoView&#39;,<tr><td><a id="l160"></a><a href="#l160">160</a><td> GET_ELEMENT_SIZE: &#39;getElementSize&#39;,<tr><td><a id="l161"></a><a href="#l161">161</a><td> GET_ELEMENT_ATTRIBUTE: &#39;getElementAttribute&#39;,<tr><td><a id="l162"></a><a href="#l162">162</a><td> GET_ELEMENT_VALUE_OF_CSS_PROPERTY: &#39;getElementValueOfCssProperty&#39;,<tr><td><a id="l163"></a><a href="#l163">163</a><td> ELEMENT_EQUALS: &#39;elementEquals&#39;,<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td> SCREENSHOT: &#39;screenshot&#39;,<tr><td><a id="l166"></a><a href="#l166">166</a><td> IMPLICITLY_WAIT: &#39;implicitlyWait&#39;,<tr><td><a id="l167"></a><a href="#l167">167</a><td> SET_SCRIPT_TIMEOUT: &#39;setScriptTimeout&#39;,<tr><td><a id="l168"></a><a href="#l168">168</a><td> SET_TIMEOUT: &#39;setTimeout&#39;,<tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td> ACCEPT_ALERT: &#39;acceptAlert&#39;,<tr><td><a id="l171"></a><a href="#l171">171</a><td> DISMISS_ALERT: &#39;dismissAlert&#39;,<tr><td><a id="l172"></a><a href="#l172">172</a><td> GET_ALERT_TEXT: &#39;getAlertText&#39;,<tr><td><a id="l173"></a><a href="#l173">173</a><td> SET_ALERT_TEXT: &#39;setAlertValue&#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> EXECUTE_SQL: &#39;executeSQL&#39;,<tr><td><a id="l176"></a><a href="#l176">176</a><td> GET_LOCATION: &#39;getLocation&#39;,<tr><td><a id="l177"></a><a href="#l177">177</a><td> SET_LOCATION: &#39;setLocation&#39;,<tr><td><a id="l178"></a><a href="#l178">178</a><td> GET_APP_CACHE: &#39;getAppCache&#39;,<tr><td><a id="l179"></a><a href="#l179">179</a><td> GET_APP_CACHE_STATUS: &#39;getStatus&#39;,<tr><td><a id="l180"></a><a href="#l180">180</a><td> CLEAR_APP_CACHE: &#39;clearAppCache&#39;,<tr><td><a id="l181"></a><a href="#l181">181</a><td> IS_BROWSER_ONLINE: &#39;isBrowserOnline&#39;,<tr><td><a id="l182"></a><a href="#l182">182</a><td> SET_BROWSER_ONLINE: &#39;setBrowserOnline&#39;,<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td> GET_LOCAL_STORAGE_ITEM: &#39;getLocalStorageItem&#39;,<tr><td><a id="l185"></a><a href="#l185">185</a><td> GET_LOCAL_STORAGE_KEYS: &#39;getLocalStorageKeys&#39;,<tr><td><a id="l186"></a><a href="#l186">186</a><td> SET_LOCAL_STORAGE_ITEM: &#39;setLocalStorageItem&#39;,<tr><td><a id="l187"></a><a href="#l187">187</a><td> REMOVE_LOCAL_STORAGE_ITEM: &#39;removeLocalStorageItem&#39;,<tr><td><a id="l188"></a><a href="#l188">188</a><td> CLEAR_LOCAL_STORAGE: &#39;clearLocalStorage&#39;,<tr><td><a id="l189"></a><a href="#l189">189</a><td> GET_LOCAL_STORAGE_SIZE: &#39;getLocalStorageSize&#39;,<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td> GET_SESSION_STORAGE_ITEM: &#39;getSessionStorageItem&#39;,<tr><td><a id="l192"></a><a href="#l192">192</a><td> GET_SESSION_STORAGE_KEYS: &#39;getSessionStorageKey&#39;,<tr><td><a id="l193"></a><a href="#l193">193</a><td> SET_SESSION_STORAGE_ITEM: &#39;setSessionStorageItem&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td> REMOVE_SESSION_STORAGE_ITEM: &#39;removeSessionStorageItem&#39;,<tr><td><a id="l195"></a><a href="#l195">195</a><td> CLEAR_SESSION_STORAGE: &#39;clearSessionStorage&#39;,<tr><td><a id="l196"></a><a href="#l196">196</a><td> GET_SESSION_STORAGE_SIZE: &#39;getSessionStorageSize&#39;,<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td> SET_SCREEN_ORIENTATION: &#39;setScreenOrientation&#39;,<tr><td><a id="l199"></a><a href="#l199">199</a><td> GET_SCREEN_ORIENTATION: &#39;getScreenOrientation&#39;,<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td> // These belong to the Advanced user interactions - an element is<tr><td><a id="l202"></a><a href="#l202">202</a><td> // optional for these commands.<tr><td><a id="l203"></a><a href="#l203">203</a><td> CLICK: &#39;mouseClick&#39;,<tr><td><a id="l204"></a><a href="#l204">204</a><td> DOUBLE_CLICK: &#39;mouseDoubleClick&#39;,<tr><td><a id="l205"></a><a href="#l205">205</a><td> MOUSE_DOWN: &#39;mouseButtonDown&#39;,<tr><td><a id="l206"></a><a href="#l206">206</a><td> MOUSE_UP: &#39;mouseButtonUp&#39;,<tr><td><a id="l207"></a><a href="#l207">207</a><td> MOVE_TO: &#39;mouseMoveTo&#39;,<tr><td><a id="l208"></a><a href="#l208">208</a><td> SEND_KEYS_TO_ACTIVE_ELEMENT: &#39;sendKeysToActiveElement&#39;,<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td> // These belong to the Advanced Touch API<tr><td><a id="l211"></a><a href="#l211">211</a><td> TOUCH_SINGLE_TAP: &#39;touchSingleTap&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td> TOUCH_DOWN: &#39;touchDown&#39;,<tr><td><a id="l213"></a><a href="#l213">213</a><td> TOUCH_UP: &#39;touchUp&#39;,<tr><td><a id="l214"></a><a href="#l214">214</a><td> TOUCH_MOVE: &#39;touchMove&#39;,<tr><td><a id="l215"></a><a href="#l215">215</a><td> TOUCH_SCROLL: &#39;touchScroll&#39;,<tr><td><a id="l216"></a><a href="#l216">216</a><td> TOUCH_DOUBLE_TAP: &#39;touchDoubleTap&#39;,<tr><td><a id="l217"></a><a href="#l217">217</a><td> TOUCH_LONG_PRESS: &#39;touchLongPress&#39;,<tr><td><a id="l218"></a><a href="#l218">218</a><td> TOUCH_FLICK: &#39;touchFlick&#39;,<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td> GET_AVAILABLE_LOG_TYPES: &#39;getAvailableLogTypes&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td> GET_LOG: &#39;getLog&#39;,<tr><td><a id="l222"></a><a href="#l222">222</a><td> GET_SESSION_LOGS: &#39;getSessionLogs&#39;,<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td> // Non-standard commands used by the standalone Selenium server.<tr><td><a id="l225"></a><a href="#l225">225</a><td> UPLOAD_FILE: &#39;uploadFile&#39;<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Handles the execution of WebDriver {@link webdriver.Command commands}.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @interface<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>webdriver.CommandExecutor = function() {};<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>/**<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Executes the given {@code command}. If there is an error executing the<tr><td><a id="l239"></a><a href="#l239">239</a><td> * command, the provided callback will be invoked with the offending error.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Otherwise, the callback will be invoked with a null Error and non-null<tr><td><a id="l241"></a><a href="#l241">241</a><td> * {@link bot.response.ResponseObject} object.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {!webdriver.Command} command The command to execute.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {function(Error, !bot.response.ResponseObject=)} callback the function<tr><td><a id="l244"></a><a href="#l244">244</a><td> * to invoke when the command response is ready.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>webdriver.CommandExecutor.prototype.execute = goog.abstractMethod;</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/lib/webdriver/events.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>events.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>lib/webdriver/events.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 A light weight event system modeled after Node&#39;s EventEmitter.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.EventEmitter&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Object that can emit events for others to listen for. This is used instead<tr><td><a id="l28"></a><a href="#l28">28</a><td> * of Closure&#39;s event system because it is much more light weight. The API is<tr><td><a id="l29"></a><a href="#l29">29</a><td> * based on Node&#39;s EventEmitters.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @constructor<tr><td><a id="l31"></a><a href="#l31">31</a><td> */<tr><td><a id="l32"></a><a href="#l32">32</a><td>webdriver.EventEmitter = function() {<tr><td><a id="l33"></a><a href="#l33">33</a><td> /**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Map of events to registered listeners.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @private {!Object.&lt;!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a id="l36"></a><a href="#l36">36</a><td> * scope: (Object|undefined)}&gt;&gt;}<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td> this.events_ = {};<tr><td><a id="l39"></a><a href="#l39">39</a><td>};<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * Fires an event and calls all listeners.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {string} type The type of event to emit.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {...*} var_args Any arguments to pass to each listener.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>webdriver.EventEmitter.prototype.emit = function(type, var_args) {<tr><td><a id="l48"></a><a href="#l48">48</a><td> var args = Array.prototype.slice.call(arguments, 1);<tr><td><a id="l49"></a><a href="#l49">49</a><td> var listeners = this.events_[type];<tr><td><a id="l50"></a><a href="#l50">50</a><td> if (!listeners) {<tr><td><a id="l51"></a><a href="#l51">51</a><td> return;<tr><td><a id="l52"></a><a href="#l52">52</a><td> }<tr><td><a id="l53"></a><a href="#l53">53</a><td> for (var i = 0; i &lt; listeners.length;) {<tr><td><a id="l54"></a><a href="#l54">54</a><td> var listener = listeners[i];<tr><td><a id="l55"></a><a href="#l55">55</a><td> listener.fn.apply(listener.scope, args);<tr><td><a id="l56"></a><a href="#l56">56</a><td> if (listeners[i] === listener) {<tr><td><a id="l57"></a><a href="#l57">57</a><td> if (listeners[i].oneshot) {<tr><td><a id="l58"></a><a href="#l58">58</a><td> listeners.splice(i, 1);<tr><td><a id="l59"></a><a href="#l59">59</a><td> } else {<tr><td><a id="l60"></a><a href="#l60">60</a><td> i += 1;<tr><td><a id="l61"></a><a href="#l61">61</a><td> }<tr><td><a id="l62"></a><a href="#l62">62</a><td> }<tr><td><a id="l63"></a><a href="#l63">63</a><td> }<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * Returns a mutable list of listeners for a specific type of event.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @param {string} type The type of event to retrieve the listeners for.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a id="l71"></a><a href="#l71">71</a><td> * scope: (Object|undefined)}&gt;} The registered listeners for<tr><td><a id="l72"></a><a href="#l72">72</a><td> * the given event type.<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>webdriver.EventEmitter.prototype.listeners = function(type) {<tr><td><a id="l75"></a><a href="#l75">75</a><td> var listeners = this.events_[type];<tr><td><a id="l76"></a><a href="#l76">76</a><td> if (!listeners) {<tr><td><a id="l77"></a><a href="#l77">77</a><td> listeners = this.events_[type] = [];<tr><td><a id="l78"></a><a href="#l78">78</a><td> }<tr><td><a id="l79"></a><a href="#l79">79</a><td> return listeners;<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> * Registers a listener.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {boolean=} opt_oneshot Whether the listener should be removed after<tr><td><a id="l89"></a><a href="#l89">89</a><td> * the first event is fired.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @private<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>webdriver.EventEmitter.prototype.addListener_ = function(type, listenerFn,<tr><td><a id="l94"></a><a href="#l94">94</a><td> opt_scope, opt_oneshot) {<tr><td><a id="l95"></a><a href="#l95">95</a><td> var listeners = this.listeners(type);<tr><td><a id="l96"></a><a href="#l96">96</a><td> var n = listeners.length;<tr><td><a id="l97"></a><a href="#l97">97</a><td> for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l98"></a><a href="#l98">98</a><td> if (listeners[i].fn == listenerFn) {<tr><td><a id="l99"></a><a href="#l99">99</a><td> return this;<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> listeners.push({<tr><td><a id="l104"></a><a href="#l104">104</a><td> fn: listenerFn,<tr><td><a id="l105"></a><a href="#l105">105</a><td> scope: opt_scope,<tr><td><a id="l106"></a><a href="#l106">106</a><td> oneshot: !!opt_oneshot<tr><td><a id="l107"></a><a href="#l107">107</a><td> });<tr><td><a id="l108"></a><a href="#l108">108</a><td> return this;<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>/**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * Registers a listener.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>webdriver.EventEmitter.prototype.addListener = function(type, listenerFn,<tr><td><a id="l120"></a><a href="#l120">120</a><td> opt_scope) {<tr><td><a id="l121"></a><a href="#l121">121</a><td> return this.addListener_(type, listenerFn, opt_scope);<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>/**<tr><td><a id="l126"></a><a href="#l126">126</a><td> * Registers a one-time listener which will be called only the first time an<tr><td><a id="l127"></a><a href="#l127">127</a><td> * event is emitted, after which it will be removed.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>webdriver.EventEmitter.prototype.once = function(type, listenerFn, opt_scope) {<tr><td><a id="l134"></a><a href="#l134">134</a><td> return this.addListener_(type, listenerFn, opt_scope, true);<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>/**<tr><td><a id="l139"></a><a href="#l139">139</a><td> * An alias for {@code #addListener()}.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>webdriver.EventEmitter.prototype.on =<tr><td><a id="l146"></a><a href="#l146">146</a><td> webdriver.EventEmitter.prototype.addListener;<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Removes a previously registered event listener.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {string} type The type of event to unregister.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {!Function} listenerFn The handler function to remove.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>webdriver.EventEmitter.prototype.removeListener = function(type, listenerFn) {<tr><td><a id="l156"></a><a href="#l156">156</a><td> var listeners = this.events_[type];<tr><td><a id="l157"></a><a href="#l157">157</a><td> if (listeners) {<tr><td><a id="l158"></a><a href="#l158">158</a><td> var n = listeners.length;<tr><td><a id="l159"></a><a href="#l159">159</a><td> for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> if (listeners[i].fn == listenerFn) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> listeners.splice(i, 1);<tr><td><a id="l162"></a><a href="#l162">162</a><td> return this;<tr><td><a id="l163"></a><a href="#l163">163</a><td> }<tr><td><a id="l164"></a><a href="#l164">164</a><td> }<tr><td><a id="l165"></a><a href="#l165">165</a><td> }<tr><td><a id="l166"></a><a href="#l166">166</a><td> return this;<tr><td><a id="l167"></a><a href="#l167">167</a><td>};<tr><td><a id="l168"></a><a href="#l168">168</a><td><tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td>/**<tr><td><a id="l171"></a><a href="#l171">171</a><td> * Removes all listeners for a specific type of event. If no event is<tr><td><a id="l172"></a><a href="#l172">172</a><td> * specified, all listeners across all types will be removed.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {string=} opt_type The type of event to remove listeners from.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>webdriver.EventEmitter.prototype.removeAllListeners = function(opt_type) {<tr><td><a id="l177"></a><a href="#l177">177</a><td> goog.isDef(opt_type) ? delete this.events_[opt_type] : this.events_ = {};<tr><td><a id="l178"></a><a href="#l178">178</a><td> return this;<tr><td><a id="l179"></a><a href="#l179">179</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/lib/webdriver/http/http.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>http.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>lib/webdriver/http/http.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 {@code webdriver.CommandExecutor} that communicates<tr><td><a id="l20"></a><a href="#l20">20</a><td> * with a server over HTTP.<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>goog.provide(&#39;webdriver.http.Client&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.http.Executor&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.http.Request&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;webdriver.http.Response&#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>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;webdriver.CommandExecutor&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;webdriver.logging&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;webdriver.promise&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td><tr><td><a id="l37"></a><a href="#l37">37</a><td>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Interface used for sending individual HTTP requests to the server.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @interface<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>webdriver.http.Client = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Sends a request to the server. If an error occurs while sending the request,<tr><td><a id="l47"></a><a href="#l47">47</a><td> * such as a failure to connect to the server, the provided callback will be<tr><td><a id="l48"></a><a href="#l48">48</a><td> * invoked with a non-null {@link Error} describing the error. Otherwise, when<tr><td><a id="l49"></a><a href="#l49">49</a><td> * the server&#39;s response has been received, the callback will be invoked with a<tr><td><a id="l50"></a><a href="#l50">50</a><td> * null Error and non-null {@link webdriver.http.Response} object.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @param {!webdriver.http.Request} request The request to send.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @param {function(Error, !webdriver.http.Response=)} callback the function to<tr><td><a id="l54"></a><a href="#l54">54</a><td> * invoke when the server&#39;s response is ready.<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td>webdriver.http.Client.prototype.send = function(request, callback) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>/**<tr><td><a id="l62"></a><a href="#l62">62</a><td> * A command executor that communicates with a server using the WebDriver<tr><td><a id="l63"></a><a href="#l63">63</a><td> * command protocol.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {!webdriver.http.Client} client The client to use when sending<tr><td><a id="l65"></a><a href="#l65">65</a><td> * requests to the server.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @constructor<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>webdriver.http.Executor = function(client) {<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> * Client used to communicate with the server.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @private {!webdriver.http.Client}<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.client_ = client;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @private {!Object&lt;{method:string, path:string}&gt;}<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td> this.customCommands_ = {};<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> * @private {!webdriver.logging.Logger}<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td> this.log_ = webdriver.logging.getLogger(&#39;webdriver.http.Executor&#39;);<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td>/**<tr><td><a id="l90"></a><a href="#l90">90</a><td> * Defines a new command for use with this executor. When a command is sent,<tr><td><a id="l91"></a><a href="#l91">91</a><td> * the {@code path} will be preprocessed using the command&#39;s parameters; any<tr><td><a id="l92"></a><a href="#l92">92</a><td> * path segments prefixed with &quot;:&quot; will be replaced by the parameter of the<tr><td><a id="l93"></a><a href="#l93">93</a><td> * same name. For example, given &quot;/person/:name&quot; and the parameters<tr><td><a id="l94"></a><a href="#l94">94</a><td> * &quot;{name: &#39;Bob&#39;}&quot;, the final command path will be &quot;/person/Bob&quot;.<tr><td><a id="l95"></a><a href="#l95">95</a><td> *<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {string} name The command name.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {string} method The HTTP method to use when sending this command.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {string} path The path to send the command to, relative to<tr><td><a id="l99"></a><a href="#l99">99</a><td> * the WebDriver server&#39;s command root and of the form<tr><td><a id="l100"></a><a href="#l100">100</a><td> * &quot;/path/:variable/segment&quot;.<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>webdriver.http.Executor.prototype.defineCommand = function(<tr><td><a id="l103"></a><a href="#l103">103</a><td> name, method, path) {<tr><td><a id="l104"></a><a href="#l104">104</a><td> this.customCommands_[name] = {method: method, path: path};<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>/** @override */<tr><td><a id="l109"></a><a href="#l109">109</a><td>webdriver.http.Executor.prototype.execute = function(command, callback) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> var resource =<tr><td><a id="l111"></a><a href="#l111">111</a><td> this.customCommands_[command.getName()] ||<tr><td><a id="l112"></a><a href="#l112">112</a><td> webdriver.http.Executor.COMMAND_MAP_[command.getName()];<tr><td><a id="l113"></a><a href="#l113">113</a><td> if (!resource) {<tr><td><a id="l114"></a><a href="#l114">114</a><td> throw new Error(&#39;Unrecognized command: &#39; + command.getName());<tr><td><a id="l115"></a><a href="#l115">115</a><td> }<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td> var parameters = command.getParameters();<tr><td><a id="l118"></a><a href="#l118">118</a><td> var path = webdriver.http.Executor.buildPath_(resource.path, parameters);<tr><td><a id="l119"></a><a href="#l119">119</a><td> var request = new webdriver.http.Request(resource.method, path, parameters);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td> var log = this.log_;<tr><td><a id="l122"></a><a href="#l122">122</a><td> log.finer(function() {<tr><td><a id="l123"></a><a href="#l123">123</a><td> return &#39;&gt;&gt;&gt;\n&#39; + request;<tr><td><a id="l124"></a><a href="#l124">124</a><td> });<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td> this.client_.send(request, function(e, response) {<tr><td><a id="l127"></a><a href="#l127">127</a><td> var responseObj;<tr><td><a id="l128"></a><a href="#l128">128</a><td> if (!e) {<tr><td><a id="l129"></a><a href="#l129">129</a><td> log.finer(function() {<tr><td><a id="l130"></a><a href="#l130">130</a><td> return &#39;&lt;&lt;&lt;\n&#39; + response;<tr><td><a id="l131"></a><a href="#l131">131</a><td> });<tr><td><a id="l132"></a><a href="#l132">132</a><td> try {<tr><td><a id="l133"></a><a href="#l133">133</a><td> responseObj = webdriver.http.Executor.parseHttpResponse_(<tr><td><a id="l134"></a><a href="#l134">134</a><td> /** @type {!webdriver.http.Response} */ (response));<tr><td><a id="l135"></a><a href="#l135">135</a><td> } catch (ex) {<tr><td><a id="l136"></a><a href="#l136">136</a><td> log.warning(&#39;Error parsing response&#39;, ex);<tr><td><a id="l137"></a><a href="#l137">137</a><td> e = ex;<tr><td><a id="l138"></a><a href="#l138">138</a><td> }<tr><td><a id="l139"></a><a href="#l139">139</a><td> }<tr><td><a id="l140"></a><a href="#l140">140</a><td> callback(e, responseObj);<tr><td><a id="l141"></a><a href="#l141">141</a><td> });<tr><td><a id="l142"></a><a href="#l142">142</a><td>};<tr><td><a id="l143"></a><a href="#l143">143</a><td><tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td>/**<tr><td><a id="l146"></a><a href="#l146">146</a><td> * Builds a fully qualified path using the given set of command parameters. Each<tr><td><a id="l147"></a><a href="#l147">147</a><td> * path segment prefixed with &#39;:&#39; will be replaced by the value of the<tr><td><a id="l148"></a><a href="#l148">148</a><td> * corresponding parameter. All parameters spliced into the path will be<tr><td><a id="l149"></a><a href="#l149">149</a><td> * removed from the parameter map.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {string} path The original resource path.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {!Object.&lt;*&gt;} parameters The parameters object to splice into<tr><td><a id="l152"></a><a href="#l152">152</a><td> * the path.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {string} The modified path.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @private<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>webdriver.http.Executor.buildPath_ = function(path, parameters) {<tr><td><a id="l157"></a><a href="#l157">157</a><td> var pathParameters = path.match(/\/:(\w+)\b/g);<tr><td><a id="l158"></a><a href="#l158">158</a><td> if (pathParameters) {<tr><td><a id="l159"></a><a href="#l159">159</a><td> for (var i = 0; i &lt; pathParameters.length; ++i) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> var key = pathParameters[i].substring(2); // Trim the /:<tr><td><a id="l161"></a><a href="#l161">161</a><td> if (key in parameters) {<tr><td><a id="l162"></a><a href="#l162">162</a><td> var value = parameters[key];<tr><td><a id="l163"></a><a href="#l163">163</a><td> // TODO: move webdriver.WebElement.ELEMENT definition to a<tr><td><a id="l164"></a><a href="#l164">164</a><td> // common file so we can reference it here without pulling in all of<tr><td><a id="l165"></a><a href="#l165">165</a><td> // webdriver.WebElement&#39;s dependencies.<tr><td><a id="l166"></a><a href="#l166">166</a><td> if (value &amp;&amp; value[&#39;ELEMENT&#39;]) {<tr><td><a id="l167"></a><a href="#l167">167</a><td> // When inserting a WebElement into the URL, only use its ID value,<tr><td><a id="l168"></a><a href="#l168">168</a><td> // not the full JSON.<tr><td><a id="l169"></a><a href="#l169">169</a><td> value = value[&#39;ELEMENT&#39;];<tr><td><a id="l170"></a><a href="#l170">170</a><td> }<tr><td><a id="l171"></a><a href="#l171">171</a><td> path = path.replace(pathParameters[i], &#39;/&#39; + value);<tr><td><a id="l172"></a><a href="#l172">172</a><td> delete parameters[key];<tr><td><a id="l173"></a><a href="#l173">173</a><td> } else {<tr><td><a id="l174"></a><a href="#l174">174</a><td> throw new Error(&#39;Missing required parameter: &#39; + key);<tr><td><a id="l175"></a><a href="#l175">175</a><td> }<tr><td><a id="l176"></a><a href="#l176">176</a><td> }<tr><td><a id="l177"></a><a href="#l177">177</a><td> }<tr><td><a id="l178"></a><a href="#l178">178</a><td> return path;<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> * Callback used to parse {@link webdriver.http.Response} objects from a<tr><td><a id="l184"></a><a href="#l184">184</a><td> * {@link webdriver.http.Client}.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {!webdriver.http.Response} httpResponse The HTTP response to parse.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @return {!bot.response.ResponseObject} The parsed response.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @private<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>webdriver.http.Executor.parseHttpResponse_ = function(httpResponse) {<tr><td><a id="l190"></a><a href="#l190">190</a><td> try {<tr><td><a id="l191"></a><a href="#l191">191</a><td> return /** @type {!bot.response.ResponseObject} */ (JSON.parse(<tr><td><a id="l192"></a><a href="#l192">192</a><td> httpResponse.body));<tr><td><a id="l193"></a><a href="#l193">193</a><td> } catch (ex) {<tr><td><a id="l194"></a><a href="#l194">194</a><td> // Whoops, looks like the server sent us a malformed response. We&#39;ll need<tr><td><a id="l195"></a><a href="#l195">195</a><td> // to manually build a response object based on the response code.<tr><td><a id="l196"></a><a href="#l196">196</a><td> }<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td> var response = {<tr><td><a id="l199"></a><a href="#l199">199</a><td> &#39;status&#39;: bot.ErrorCode.SUCCESS,<tr><td><a id="l200"></a><a href="#l200">200</a><td> &#39;value&#39;: httpResponse.body.replace(/\r\n/g, &#39;\n&#39;)<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> if (!(httpResponse.status &gt; 199 &amp;&amp; httpResponse.status &lt; 300)) {<tr><td><a id="l204"></a><a href="#l204">204</a><td> // 404 represents an unknown command; anything else is a generic unknown<tr><td><a id="l205"></a><a href="#l205">205</a><td> // error.<tr><td><a id="l206"></a><a href="#l206">206</a><td> response[&#39;status&#39;] = httpResponse.status == 404 ?<tr><td><a id="l207"></a><a href="#l207">207</a><td> bot.ErrorCode.UNKNOWN_COMMAND :<tr><td><a id="l208"></a><a href="#l208">208</a><td> bot.ErrorCode.UNKNOWN_ERROR;<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> return response;<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Maps command names to resource locator.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @private {!Object.&lt;{method:string, path:string}&gt;}<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @const<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>webdriver.http.Executor.COMMAND_MAP_ = (function() {<tr><td><a id="l221"></a><a href="#l221">221</a><td> return new Builder().<tr><td><a id="l222"></a><a href="#l222">222</a><td> put(webdriver.CommandName.GET_SERVER_STATUS, get(&#39;/status&#39;)).<tr><td><a id="l223"></a><a href="#l223">223</a><td> put(webdriver.CommandName.NEW_SESSION, post(&#39;/session&#39;)).<tr><td><a id="l224"></a><a href="#l224">224</a><td> put(webdriver.CommandName.GET_SESSIONS, get(&#39;/sessions&#39;)).<tr><td><a id="l225"></a><a href="#l225">225</a><td> put(webdriver.CommandName.DESCRIBE_SESSION, get(&#39;/session/:sessionId&#39;)).<tr><td><a id="l226"></a><a href="#l226">226</a><td> put(webdriver.CommandName.QUIT, del(&#39;/session/:sessionId&#39;)).<tr><td><a id="l227"></a><a href="#l227">227</a><td> put(webdriver.CommandName.CLOSE, del(&#39;/session/:sessionId/window&#39;)).<tr><td><a id="l228"></a><a href="#l228">228</a><td> put(webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE,<tr><td><a id="l229"></a><a href="#l229">229</a><td> get(&#39;/session/:sessionId/window_handle&#39;)).<tr><td><a id="l230"></a><a href="#l230">230</a><td> put(webdriver.CommandName.GET_WINDOW_HANDLES,<tr><td><a id="l231"></a><a href="#l231">231</a><td> get(&#39;/session/:sessionId/window_handles&#39;)).<tr><td><a id="l232"></a><a href="#l232">232</a><td> put(webdriver.CommandName.GET_CURRENT_URL,<tr><td><a id="l233"></a><a href="#l233">233</a><td> get(&#39;/session/:sessionId/url&#39;)).<tr><td><a id="l234"></a><a href="#l234">234</a><td> put(webdriver.CommandName.GET, post(&#39;/session/:sessionId/url&#39;)).<tr><td><a id="l235"></a><a href="#l235">235</a><td> put(webdriver.CommandName.GO_BACK, post(&#39;/session/:sessionId/back&#39;)).<tr><td><a id="l236"></a><a href="#l236">236</a><td> put(webdriver.CommandName.GO_FORWARD,<tr><td><a id="l237"></a><a href="#l237">237</a><td> post(&#39;/session/:sessionId/forward&#39;)).<tr><td><a id="l238"></a><a href="#l238">238</a><td> put(webdriver.CommandName.REFRESH,<tr><td><a id="l239"></a><a href="#l239">239</a><td> post(&#39;/session/:sessionId/refresh&#39;)).<tr><td><a id="l240"></a><a href="#l240">240</a><td> put(webdriver.CommandName.ADD_COOKIE,<tr><td><a id="l241"></a><a href="#l241">241</a><td> post(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l242"></a><a href="#l242">242</a><td> put(webdriver.CommandName.GET_ALL_COOKIES,<tr><td><a id="l243"></a><a href="#l243">243</a><td> get(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l244"></a><a href="#l244">244</a><td> put(webdriver.CommandName.DELETE_ALL_COOKIES,<tr><td><a id="l245"></a><a href="#l245">245</a><td> del(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l246"></a><a href="#l246">246</a><td> put(webdriver.CommandName.DELETE_COOKIE,<tr><td><a id="l247"></a><a href="#l247">247</a><td> del(&#39;/session/:sessionId/cookie/:name&#39;)).<tr><td><a id="l248"></a><a href="#l248">248</a><td> put(webdriver.CommandName.FIND_ELEMENT,<tr><td><a id="l249"></a><a href="#l249">249</a><td> post(&#39;/session/:sessionId/element&#39;)).<tr><td><a id="l250"></a><a href="#l250">250</a><td> put(webdriver.CommandName.FIND_ELEMENTS,<tr><td><a id="l251"></a><a href="#l251">251</a><td> post(&#39;/session/:sessionId/elements&#39;)).<tr><td><a id="l252"></a><a href="#l252">252</a><td> put(webdriver.CommandName.GET_ACTIVE_ELEMENT,<tr><td><a id="l253"></a><a href="#l253">253</a><td> post(&#39;/session/:sessionId/element/active&#39;)).<tr><td><a id="l254"></a><a href="#l254">254</a><td> put(webdriver.CommandName.FIND_CHILD_ELEMENT,<tr><td><a id="l255"></a><a href="#l255">255</a><td> post(&#39;/session/:sessionId/element/:id/element&#39;)).<tr><td><a id="l256"></a><a href="#l256">256</a><td> put(webdriver.CommandName.FIND_CHILD_ELEMENTS,<tr><td><a id="l257"></a><a href="#l257">257</a><td> post(&#39;/session/:sessionId/element/:id/elements&#39;)).<tr><td><a id="l258"></a><a href="#l258">258</a><td> put(webdriver.CommandName.CLEAR_ELEMENT,<tr><td><a id="l259"></a><a href="#l259">259</a><td> post(&#39;/session/:sessionId/element/:id/clear&#39;)).<tr><td><a id="l260"></a><a href="#l260">260</a><td> put(webdriver.CommandName.CLICK_ELEMENT,<tr><td><a id="l261"></a><a href="#l261">261</a><td> post(&#39;/session/:sessionId/element/:id/click&#39;)).<tr><td><a id="l262"></a><a href="#l262">262</a><td> put(webdriver.CommandName.SEND_KEYS_TO_ELEMENT,<tr><td><a id="l263"></a><a href="#l263">263</a><td> post(&#39;/session/:sessionId/element/:id/value&#39;)).<tr><td><a id="l264"></a><a href="#l264">264</a><td> put(webdriver.CommandName.SUBMIT_ELEMENT,<tr><td><a id="l265"></a><a href="#l265">265</a><td> post(&#39;/session/:sessionId/element/:id/submit&#39;)).<tr><td><a id="l266"></a><a href="#l266">266</a><td> put(webdriver.CommandName.GET_ELEMENT_TEXT,<tr><td><a id="l267"></a><a href="#l267">267</a><td> get(&#39;/session/:sessionId/element/:id/text&#39;)).<tr><td><a id="l268"></a><a href="#l268">268</a><td> put(webdriver.CommandName.GET_ELEMENT_TAG_NAME,<tr><td><a id="l269"></a><a href="#l269">269</a><td> get(&#39;/session/:sessionId/element/:id/name&#39;)).<tr><td><a id="l270"></a><a href="#l270">270</a><td> put(webdriver.CommandName.IS_ELEMENT_SELECTED,<tr><td><a id="l271"></a><a href="#l271">271</a><td> get(&#39;/session/:sessionId/element/:id/selected&#39;)).<tr><td><a id="l272"></a><a href="#l272">272</a><td> put(webdriver.CommandName.IS_ELEMENT_ENABLED,<tr><td><a id="l273"></a><a href="#l273">273</a><td> get(&#39;/session/:sessionId/element/:id/enabled&#39;)).<tr><td><a id="l274"></a><a href="#l274">274</a><td> put(webdriver.CommandName.IS_ELEMENT_DISPLAYED,<tr><td><a id="l275"></a><a href="#l275">275</a><td> get(&#39;/session/:sessionId/element/:id/displayed&#39;)).<tr><td><a id="l276"></a><a href="#l276">276</a><td> put(webdriver.CommandName.GET_ELEMENT_LOCATION,<tr><td><a id="l277"></a><a href="#l277">277</a><td> get(&#39;/session/:sessionId/element/:id/location&#39;)).<tr><td><a id="l278"></a><a href="#l278">278</a><td> put(webdriver.CommandName.GET_ELEMENT_SIZE,<tr><td><a id="l279"></a><a href="#l279">279</a><td> get(&#39;/session/:sessionId/element/:id/size&#39;)).<tr><td><a id="l280"></a><a href="#l280">280</a><td> put(webdriver.CommandName.GET_ELEMENT_ATTRIBUTE,<tr><td><a id="l281"></a><a href="#l281">281</a><td> get(&#39;/session/:sessionId/element/:id/attribute/:name&#39;)).<tr><td><a id="l282"></a><a href="#l282">282</a><td> put(webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY,<tr><td><a id="l283"></a><a href="#l283">283</a><td> get(&#39;/session/:sessionId/element/:id/css/:propertyName&#39;)).<tr><td><a id="l284"></a><a href="#l284">284</a><td> put(webdriver.CommandName.ELEMENT_EQUALS,<tr><td><a id="l285"></a><a href="#l285">285</a><td> get(&#39;/session/:sessionId/element/:id/equals/:other&#39;)).<tr><td><a id="l286"></a><a href="#l286">286</a><td> put(webdriver.CommandName.SWITCH_TO_WINDOW,<tr><td><a id="l287"></a><a href="#l287">287</a><td> post(&#39;/session/:sessionId/window&#39;)).<tr><td><a id="l288"></a><a href="#l288">288</a><td> put(webdriver.CommandName.MAXIMIZE_WINDOW,<tr><td><a id="l289"></a><a href="#l289">289</a><td> post(&#39;/session/:sessionId/window/:windowHandle/maximize&#39;)).<tr><td><a id="l290"></a><a href="#l290">290</a><td> put(webdriver.CommandName.GET_WINDOW_POSITION,<tr><td><a id="l291"></a><a href="#l291">291</a><td> get(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a id="l292"></a><a href="#l292">292</a><td> put(webdriver.CommandName.SET_WINDOW_POSITION,<tr><td><a id="l293"></a><a href="#l293">293</a><td> post(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a id="l294"></a><a href="#l294">294</a><td> put(webdriver.CommandName.GET_WINDOW_SIZE,<tr><td><a id="l295"></a><a href="#l295">295</a><td> get(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a id="l296"></a><a href="#l296">296</a><td> put(webdriver.CommandName.SET_WINDOW_SIZE,<tr><td><a id="l297"></a><a href="#l297">297</a><td> post(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a id="l298"></a><a href="#l298">298</a><td> put(webdriver.CommandName.SWITCH_TO_FRAME,<tr><td><a id="l299"></a><a href="#l299">299</a><td> post(&#39;/session/:sessionId/frame&#39;)).<tr><td><a id="l300"></a><a href="#l300">300</a><td> put(webdriver.CommandName.GET_PAGE_SOURCE,<tr><td><a id="l301"></a><a href="#l301">301</a><td> get(&#39;/session/:sessionId/source&#39;)).<tr><td><a id="l302"></a><a href="#l302">302</a><td> put(webdriver.CommandName.GET_TITLE,<tr><td><a id="l303"></a><a href="#l303">303</a><td> get(&#39;/session/:sessionId/title&#39;)).<tr><td><a id="l304"></a><a href="#l304">304</a><td> put(webdriver.CommandName.EXECUTE_SCRIPT,<tr><td><a id="l305"></a><a href="#l305">305</a><td> post(&#39;/session/:sessionId/execute&#39;)).<tr><td><a id="l306"></a><a href="#l306">306</a><td> put(webdriver.CommandName.EXECUTE_ASYNC_SCRIPT,<tr><td><a id="l307"></a><a href="#l307">307</a><td> post(&#39;/session/:sessionId/execute_async&#39;)).<tr><td><a id="l308"></a><a href="#l308">308</a><td> put(webdriver.CommandName.SCREENSHOT,<tr><td><a id="l309"></a><a href="#l309">309</a><td> get(&#39;/session/:sessionId/screenshot&#39;)).<tr><td><a id="l310"></a><a href="#l310">310</a><td> put(webdriver.CommandName.SET_TIMEOUT,<tr><td><a id="l311"></a><a href="#l311">311</a><td> post(&#39;/session/:sessionId/timeouts&#39;)).<tr><td><a id="l312"></a><a href="#l312">312</a><td> put(webdriver.CommandName.SET_SCRIPT_TIMEOUT,<tr><td><a id="l313"></a><a href="#l313">313</a><td> post(&#39;/session/:sessionId/timeouts/async_script&#39;)).<tr><td><a id="l314"></a><a href="#l314">314</a><td> put(webdriver.CommandName.IMPLICITLY_WAIT,<tr><td><a id="l315"></a><a href="#l315">315</a><td> post(&#39;/session/:sessionId/timeouts/implicit_wait&#39;)).<tr><td><a id="l316"></a><a href="#l316">316</a><td> put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a id="l317"></a><a href="#l317">317</a><td> put(webdriver.CommandName.CLICK, post(&#39;/session/:sessionId/click&#39;)).<tr><td><a id="l318"></a><a href="#l318">318</a><td> put(webdriver.CommandName.DOUBLE_CLICK,<tr><td><a id="l319"></a><a href="#l319">319</a><td> post(&#39;/session/:sessionId/doubleclick&#39;)).<tr><td><a id="l320"></a><a href="#l320">320</a><td> put(webdriver.CommandName.MOUSE_DOWN,<tr><td><a id="l321"></a><a href="#l321">321</a><td> post(&#39;/session/:sessionId/buttondown&#39;)).<tr><td><a id="l322"></a><a href="#l322">322</a><td> put(webdriver.CommandName.MOUSE_UP, post(&#39;/session/:sessionId/buttonup&#39;)).<tr><td><a id="l323"></a><a href="#l323">323</a><td> put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a id="l324"></a><a href="#l324">324</a><td> put(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT,<tr><td><a id="l325"></a><a href="#l325">325</a><td> post(&#39;/session/:sessionId/keys&#39;)).<tr><td><a id="l326"></a><a href="#l326">326</a><td> put(webdriver.CommandName.TOUCH_SINGLE_TAP,<tr><td><a id="l327"></a><a href="#l327">327</a><td> post(&#39;/session/:sessionId/touch/click&#39;)).<tr><td><a id="l328"></a><a href="#l328">328</a><td> put(webdriver.CommandName.TOUCH_DOUBLE_TAP,<tr><td><a id="l329"></a><a href="#l329">329</a><td> post(&#39;/session/:sessionId/touch/doubleclick&#39;)).<tr><td><a id="l330"></a><a href="#l330">330</a><td> put(webdriver.CommandName.TOUCH_DOWN,<tr><td><a id="l331"></a><a href="#l331">331</a><td> post(&#39;/session/:sessionId/touch/down&#39;)).<tr><td><a id="l332"></a><a href="#l332">332</a><td> put(webdriver.CommandName.TOUCH_UP,<tr><td><a id="l333"></a><a href="#l333">333</a><td> post(&#39;/session/:sessionId/touch/up&#39;)).<tr><td><a id="l334"></a><a href="#l334">334</a><td> put(webdriver.CommandName.TOUCH_MOVE,<tr><td><a id="l335"></a><a href="#l335">335</a><td> post(&#39;/session/:sessionId/touch/move&#39;)).<tr><td><a id="l336"></a><a href="#l336">336</a><td> put(webdriver.CommandName.TOUCH_SCROLL,<tr><td><a id="l337"></a><a href="#l337">337</a><td> post(&#39;/session/:sessionId/touch/scroll&#39;)).<tr><td><a id="l338"></a><a href="#l338">338</a><td> put(webdriver.CommandName.TOUCH_LONG_PRESS,<tr><td><a id="l339"></a><a href="#l339">339</a><td> post(&#39;/session/:sessionId/touch/longclick&#39;)).<tr><td><a id="l340"></a><a href="#l340">340</a><td> put(webdriver.CommandName.TOUCH_FLICK,<tr><td><a id="l341"></a><a href="#l341">341</a><td> post(&#39;/session/:sessionId/touch/flick&#39;)).<tr><td><a id="l342"></a><a href="#l342">342</a><td> put(webdriver.CommandName.ACCEPT_ALERT,<tr><td><a id="l343"></a><a href="#l343">343</a><td> post(&#39;/session/:sessionId/accept_alert&#39;)).<tr><td><a id="l344"></a><a href="#l344">344</a><td> put(webdriver.CommandName.DISMISS_ALERT,<tr><td><a id="l345"></a><a href="#l345">345</a><td> post(&#39;/session/:sessionId/dismiss_alert&#39;)).<tr><td><a id="l346"></a><a href="#l346">346</a><td> put(webdriver.CommandName.GET_ALERT_TEXT,<tr><td><a id="l347"></a><a href="#l347">347</a><td> get(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a id="l348"></a><a href="#l348">348</a><td> put(webdriver.CommandName.SET_ALERT_TEXT,<tr><td><a id="l349"></a><a href="#l349">349</a><td> post(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a id="l350"></a><a href="#l350">350</a><td> put(webdriver.CommandName.GET_LOG, post(&#39;/session/:sessionId/log&#39;)).<tr><td><a id="l351"></a><a href="#l351">351</a><td> put(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES,<tr><td><a id="l352"></a><a href="#l352">352</a><td> get(&#39;/session/:sessionId/log/types&#39;)).<tr><td><a id="l353"></a><a href="#l353">353</a><td> put(webdriver.CommandName.GET_SESSION_LOGS, post(&#39;/logs&#39;)).<tr><td><a id="l354"></a><a href="#l354">354</a><td> put(webdriver.CommandName.UPLOAD_FILE, post(&#39;/session/:sessionId/file&#39;)).<tr><td><a id="l355"></a><a href="#l355">355</a><td> build();<tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td> /** @constructor */<tr><td><a id="l358"></a><a href="#l358">358</a><td> function Builder() {<tr><td><a id="l359"></a><a href="#l359">359</a><td> var map = {};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td> this.put = function(name, resource) {<tr><td><a id="l362"></a><a href="#l362">362</a><td> map[name] = resource;<tr><td><a id="l363"></a><a href="#l363">363</a><td> return this;<tr><td><a id="l364"></a><a href="#l364">364</a><td> };<tr><td><a id="l365"></a><a href="#l365">365</a><td><tr><td><a id="l366"></a><a href="#l366">366</a><td> this.build = function() {<tr><td><a id="l367"></a><a href="#l367">367</a><td> return map;<tr><td><a id="l368"></a><a href="#l368">368</a><td> };<tr><td><a id="l369"></a><a href="#l369">369</a><td> }<tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td> function post(path) { return resource(&#39;POST&#39;, path); }<tr><td><a id="l372"></a><a href="#l372">372</a><td> function del(path) { return resource(&#39;DELETE&#39;, path); }<tr><td><a id="l373"></a><a href="#l373">373</a><td> function get(path) { return resource(&#39;GET&#39;, path); }<tr><td><a id="l374"></a><a href="#l374">374</a><td> function resource(method, path) { return {method: method, path: path}; }<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><tr><td><a id="l378"></a><a href="#l378">378</a><td>/**<tr><td><a id="l379"></a><a href="#l379">379</a><td> * Converts a headers object to a HTTP header block string.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {!Object.&lt;string&gt;} headers The headers object to convert.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @return {string} The headers as a string.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @private<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>webdriver.http.headersToString_ = function(headers) {<tr><td><a id="l385"></a><a href="#l385">385</a><td> var ret = [];<tr><td><a id="l386"></a><a href="#l386">386</a><td> for (var key in headers) {<tr><td><a id="l387"></a><a href="#l387">387</a><td> ret.push(key + &#39;: &#39; + headers[key]);<tr><td><a id="l388"></a><a href="#l388">388</a><td> }<tr><td><a id="l389"></a><a href="#l389">389</a><td> return ret.join(&#39;\n&#39;);<tr><td><a id="l390"></a><a href="#l390">390</a><td>};<tr><td><a id="l391"></a><a href="#l391">391</a><td><tr><td><a id="l392"></a><a href="#l392">392</a><td><tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td>/**<tr><td><a id="l395"></a><a href="#l395">395</a><td> * Describes a partial HTTP request. This class is a &quot;partial&quot; request and only<tr><td><a id="l396"></a><a href="#l396">396</a><td> * defines the path on the server to send a request to. It is each<tr><td><a id="l397"></a><a href="#l397">397</a><td> * {@link webdriver.http.Client}&#39;s responsibility to build the full URL for the<tr><td><a id="l398"></a><a href="#l398">398</a><td> * final request.<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @param {string} method The HTTP method to use for the request.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {string} path Path on the server to send the request to.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {Object=} opt_data This request&#39;s JSON data.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @constructor<tr><td><a id="l403"></a><a href="#l403">403</a><td> */<tr><td><a id="l404"></a><a href="#l404">404</a><td>webdriver.http.Request = function(method, path, opt_data) {<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td> /**<tr><td><a id="l407"></a><a href="#l407">407</a><td> * The HTTP method to use for the request.<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @type {string}<tr><td><a id="l409"></a><a href="#l409">409</a><td> */<tr><td><a id="l410"></a><a href="#l410">410</a><td> this.method = method;<tr><td><a id="l411"></a><a href="#l411">411</a><td><tr><td><a id="l412"></a><a href="#l412">412</a><td> /**<tr><td><a id="l413"></a><a href="#l413">413</a><td> * The path on the server to send the request to.<tr><td><a id="l414"></a><a href="#l414">414</a><td> * @type {string}<tr><td><a id="l415"></a><a href="#l415">415</a><td> */<tr><td><a id="l416"></a><a href="#l416">416</a><td> this.path = path;<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td> /**<tr><td><a id="l419"></a><a href="#l419">419</a><td> * This request&#39;s body.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @type {!Object}<tr><td><a id="l421"></a><a href="#l421">421</a><td> */<tr><td><a id="l422"></a><a href="#l422">422</a><td> this.data = opt_data || {};<tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td> /**<tr><td><a id="l425"></a><a href="#l425">425</a><td> * The headers to send with the request.<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @type {!Object.&lt;(string|number)&gt;}<tr><td><a id="l427"></a><a href="#l427">427</a><td> */<tr><td><a id="l428"></a><a href="#l428">428</a><td> this.headers = {&#39;Accept&#39;: &#39;application/json; charset=utf-8&#39;};<tr><td><a id="l429"></a><a href="#l429">429</a><td>};<tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td><tr><td><a id="l432"></a><a href="#l432">432</a><td>/** @override */<tr><td><a id="l433"></a><a href="#l433">433</a><td>webdriver.http.Request.prototype.toString = function() {<tr><td><a id="l434"></a><a href="#l434">434</a><td> return [<tr><td><a id="l435"></a><a href="#l435">435</a><td> this.method + &#39; &#39; + this.path + &#39; HTTP/1.1&#39;,<tr><td><a id="l436"></a><a href="#l436">436</a><td> webdriver.http.headersToString_(this.headers),<tr><td><a id="l437"></a><a href="#l437">437</a><td> &#39;&#39;,<tr><td><a id="l438"></a><a href="#l438">438</a><td> JSON.stringify(this.data)<tr><td><a id="l439"></a><a href="#l439">439</a><td> ].join(&#39;\n&#39;);<tr><td><a id="l440"></a><a href="#l440">440</a><td>};<tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td>/**<tr><td><a id="l445"></a><a href="#l445">445</a><td> * Represents a HTTP response.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @param {number} status The response code.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {!Object.&lt;string&gt;} headers The response headers. All header<tr><td><a id="l448"></a><a href="#l448">448</a><td> * names will be converted to lowercase strings for consistent lookups.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @param {string} body The response body.<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @constructor<tr><td><a id="l451"></a><a href="#l451">451</a><td> */<tr><td><a id="l452"></a><a href="#l452">452</a><td>webdriver.http.Response = function(status, headers, body) {<tr><td><a id="l453"></a><a href="#l453">453</a><td><tr><td><a id="l454"></a><a href="#l454">454</a><td> /**<tr><td><a id="l455"></a><a href="#l455">455</a><td> * The HTTP response code.<tr><td><a id="l456"></a><a href="#l456">456</a><td> * @type {number}<tr><td><a id="l457"></a><a href="#l457">457</a><td> */<tr><td><a id="l458"></a><a href="#l458">458</a><td> this.status = status;<tr><td><a id="l459"></a><a href="#l459">459</a><td><tr><td><a id="l460"></a><a href="#l460">460</a><td> /**<tr><td><a id="l461"></a><a href="#l461">461</a><td> * The response body.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @type {string}<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td> this.body = body;<tr><td><a id="l465"></a><a href="#l465">465</a><td><tr><td><a id="l466"></a><a href="#l466">466</a><td> /**<tr><td><a id="l467"></a><a href="#l467">467</a><td> * The response body.<tr><td><a id="l468"></a><a href="#l468">468</a><td> * @type {!Object.&lt;string&gt;}<tr><td><a id="l469"></a><a href="#l469">469</a><td> */<tr><td><a id="l470"></a><a href="#l470">470</a><td> this.headers = {};<tr><td><a id="l471"></a><a href="#l471">471</a><td> for (var header in headers) {<tr><td><a id="l472"></a><a href="#l472">472</a><td> this.headers[header.toLowerCase()] = headers[header];<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><tr><td><a id="l476"></a><a href="#l476">476</a><td><tr><td><a id="l477"></a><a href="#l477">477</a><td>/**<tr><td><a id="l478"></a><a href="#l478">478</a><td> * Builds a {@link webdriver.http.Response} from a {@link XMLHttpRequest} or<tr><td><a id="l479"></a><a href="#l479">479</a><td> * {@link XDomainRequest} response object.<tr><td><a id="l480"></a><a href="#l480">480</a><td> * @param {!(XDomainRequest|XMLHttpRequest)} xhr The request to parse.<tr><td><a id="l481"></a><a href="#l481">481</a><td> * @return {!webdriver.http.Response} The parsed response.<tr><td><a id="l482"></a><a href="#l482">482</a><td> */<tr><td><a id="l483"></a><a href="#l483">483</a><td>webdriver.http.Response.fromXmlHttpRequest = function(xhr) {<tr><td><a id="l484"></a><a href="#l484">484</a><td> var headers = {};<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td> // getAllResponseHeaders is only available on XMLHttpRequest objects.<tr><td><a id="l487"></a><a href="#l487">487</a><td> if (xhr.getAllResponseHeaders) {<tr><td><a id="l488"></a><a href="#l488">488</a><td> var tmp = xhr.getAllResponseHeaders();<tr><td><a id="l489"></a><a href="#l489">489</a><td> if (tmp) {<tr><td><a id="l490"></a><a href="#l490">490</a><td> tmp = tmp.replace(/\r\n/g, &#39;\n&#39;).split(&#39;\n&#39;);<tr><td><a id="l491"></a><a href="#l491">491</a><td> goog.array.forEach(tmp, function(header) {<tr><td><a id="l492"></a><a href="#l492">492</a><td> var parts = header.split(/\s*:\s*/, 2);<tr><td><a id="l493"></a><a href="#l493">493</a><td> if (parts[0]) {<tr><td><a id="l494"></a><a href="#l494">494</a><td> headers[parts[0]] = parts[1] || &#39;&#39;;<tr><td><a id="l495"></a><a href="#l495">495</a><td> }<tr><td><a id="l496"></a><a href="#l496">496</a><td> });<tr><td><a id="l497"></a><a href="#l497">497</a><td> }<tr><td><a id="l498"></a><a href="#l498">498</a><td> }<tr><td><a id="l499"></a><a href="#l499">499</a><td><tr><td><a id="l500"></a><a href="#l500">500</a><td> // If xhr is a XDomainRequest object, it will not have a status.<tr><td><a id="l501"></a><a href="#l501">501</a><td> // However, if we&#39;re parsing the response from a XDomainRequest, then<tr><td><a id="l502"></a><a href="#l502">502</a><td> // that request must have been a success, so we can assume status == 200.<tr><td><a id="l503"></a><a href="#l503">503</a><td> var status = xhr.status || 200;<tr><td><a id="l504"></a><a href="#l504">504</a><td> return new webdriver.http.Response(status, headers,<tr><td><a id="l505"></a><a href="#l505">505</a><td> xhr.responseText.replace(/\0/g, &#39;&#39;));<tr><td><a id="l506"></a><a href="#l506">506</a><td>};<tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td><tr><td><a id="l509"></a><a href="#l509">509</a><td>/** @override */<tr><td><a id="l510"></a><a href="#l510">510</a><td>webdriver.http.Response.prototype.toString = function() {<tr><td><a id="l511"></a><a href="#l511">511</a><td> var headers = webdriver.http.headersToString_(this.headers);<tr><td><a id="l512"></a><a href="#l512">512</a><td> var ret = [&#39;HTTP/1.1 &#39; + this.status, headers];<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td> if (headers) {<tr><td><a id="l515"></a><a href="#l515">515</a><td> ret.push(&#39;&#39;);<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> if (this.body) {<tr><td><a id="l519"></a><a href="#l519">519</a><td> ret.push(this.body);<tr><td><a id="l520"></a><a href="#l520">520</a><td> }<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td> return ret.join(&#39;\n&#39;);<tr><td><a id="l523"></a><a href="#l523">523</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/lib/webdriver/key.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>key.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>lib/webdriver/key.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>goog.provide(&#39;webdriver.Key&#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><tr><td><a id="l21"></a><a href="#l21">21</a><td>/**<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Representations of pressable keys that aren&#39;t text. These are stored in<tr><td><a id="l23"></a><a href="#l23">23</a><td> * the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF. Refer to<tr><td><a id="l24"></a><a href="#l24">24</a><td> * http://www.google.com.au/search?&amp;q=unicode+pua&amp;btnG=Search<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @enum {string}<tr><td><a id="l27"></a><a href="#l27">27</a><td> */<tr><td><a id="l28"></a><a href="#l28">28</a><td>webdriver.Key = {<tr><td><a id="l29"></a><a href="#l29">29</a><td> NULL: &#39;\uE000&#39;,<tr><td><a id="l30"></a><a href="#l30">30</a><td> CANCEL: &#39;\uE001&#39;, // ^break<tr><td><a id="l31"></a><a href="#l31">31</a><td> HELP: &#39;\uE002&#39;,<tr><td><a id="l32"></a><a href="#l32">32</a><td> BACK_SPACE: &#39;\uE003&#39;,<tr><td><a id="l33"></a><a href="#l33">33</a><td> TAB: &#39;\uE004&#39;,<tr><td><a id="l34"></a><a href="#l34">34</a><td> CLEAR: &#39;\uE005&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td> RETURN: &#39;\uE006&#39;,<tr><td><a id="l36"></a><a href="#l36">36</a><td> ENTER: &#39;\uE007&#39;,<tr><td><a id="l37"></a><a href="#l37">37</a><td> SHIFT: &#39;\uE008&#39;,<tr><td><a id="l38"></a><a href="#l38">38</a><td> CONTROL: &#39;\uE009&#39;,<tr><td><a id="l39"></a><a href="#l39">39</a><td> ALT: &#39;\uE00A&#39;,<tr><td><a id="l40"></a><a href="#l40">40</a><td> PAUSE: &#39;\uE00B&#39;,<tr><td><a id="l41"></a><a href="#l41">41</a><td> ESCAPE: &#39;\uE00C&#39;,<tr><td><a id="l42"></a><a href="#l42">42</a><td> SPACE: &#39;\uE00D&#39;,<tr><td><a id="l43"></a><a href="#l43">43</a><td> PAGE_UP: &#39;\uE00E&#39;,<tr><td><a id="l44"></a><a href="#l44">44</a><td> PAGE_DOWN: &#39;\uE00F&#39;,<tr><td><a id="l45"></a><a href="#l45">45</a><td> END: &#39;\uE010&#39;,<tr><td><a id="l46"></a><a href="#l46">46</a><td> HOME: &#39;\uE011&#39;,<tr><td><a id="l47"></a><a href="#l47">47</a><td> ARROW_LEFT: &#39;\uE012&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td> LEFT: &#39;\uE012&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td> ARROW_UP: &#39;\uE013&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td> UP: &#39;\uE013&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td> ARROW_RIGHT: &#39;\uE014&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td> RIGHT: &#39;\uE014&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td> ARROW_DOWN: &#39;\uE015&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td> DOWN: &#39;\uE015&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td> INSERT: &#39;\uE016&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td> DELETE: &#39;\uE017&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td> SEMICOLON: &#39;\uE018&#39;,<tr><td><a id="l58"></a><a href="#l58">58</a><td> EQUALS: &#39;\uE019&#39;,<tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td> NUMPAD0: &#39;\uE01A&#39;, // number pad keys<tr><td><a id="l61"></a><a href="#l61">61</a><td> NUMPAD1: &#39;\uE01B&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td> NUMPAD2: &#39;\uE01C&#39;,<tr><td><a id="l63"></a><a href="#l63">63</a><td> NUMPAD3: &#39;\uE01D&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td> NUMPAD4: &#39;\uE01E&#39;,<tr><td><a id="l65"></a><a href="#l65">65</a><td> NUMPAD5: &#39;\uE01F&#39;,<tr><td><a id="l66"></a><a href="#l66">66</a><td> NUMPAD6: &#39;\uE020&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td> NUMPAD7: &#39;\uE021&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td> NUMPAD8: &#39;\uE022&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td> NUMPAD9: &#39;\uE023&#39;,<tr><td><a id="l70"></a><a href="#l70">70</a><td> MULTIPLY: &#39;\uE024&#39;,<tr><td><a id="l71"></a><a href="#l71">71</a><td> ADD: &#39;\uE025&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td> SEPARATOR: &#39;\uE026&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td> SUBTRACT: &#39;\uE027&#39;,<tr><td><a id="l74"></a><a href="#l74">74</a><td> DECIMAL: &#39;\uE028&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td> DIVIDE: &#39;\uE029&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> F1: &#39;\uE031&#39;, // function keys<tr><td><a id="l78"></a><a href="#l78">78</a><td> F2: &#39;\uE032&#39;,<tr><td><a id="l79"></a><a href="#l79">79</a><td> F3: &#39;\uE033&#39;,<tr><td><a id="l80"></a><a href="#l80">80</a><td> F4: &#39;\uE034&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td> F5: &#39;\uE035&#39;,<tr><td><a id="l82"></a><a href="#l82">82</a><td> F6: &#39;\uE036&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td> F7: &#39;\uE037&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td> F8: &#39;\uE038&#39;,<tr><td><a id="l85"></a><a href="#l85">85</a><td> F9: &#39;\uE039&#39;,<tr><td><a id="l86"></a><a href="#l86">86</a><td> F10: &#39;\uE03A&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td> F11: &#39;\uE03B&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td> F12: &#39;\uE03C&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td> COMMAND: &#39;\uE03D&#39;, // Apple command key<tr><td><a id="l91"></a><a href="#l91">91</a><td> META: &#39;\uE03D&#39; // alias for Windows key<tr><td><a id="l92"></a><a href="#l92">92</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/lib/webdriver/locators.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>locators.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>lib/webdriver/locators.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 Factory methods for the supported locator strategies.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.By&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.Locator&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.Locator.Strategy&#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>goog.require(&#39;goog.array&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * An element locator.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} using The type of strategy to use for this locator.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {string} value The search target of this locator.<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> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>webdriver.Locator = function(using, value) {<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td> /**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * The search strategy to use when searching for an element.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {string}<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td> this.using = using;<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> * The search target for this locator.<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @type {string}<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td> this.value = value;<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> * Creates a factory function for a {@link webdriver.Locator}.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {string} type The type of locator for the factory.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {function(string): !webdriver.Locator} The new factory function.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @private<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>webdriver.Locator.factory_ = function(type) {<tr><td><a id="l61"></a><a href="#l61">61</a><td> return function(value) {<tr><td><a id="l62"></a><a href="#l62">62</a><td> return new webdriver.Locator(type, value);<tr><td><a id="l63"></a><a href="#l63">63</a><td> };<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * A collection of factory functions for creating {@link webdriver.Locator}<tr><td><a id="l69"></a><a href="#l69">69</a><td> * instances.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>webdriver.By = {};<tr><td><a id="l72"></a><a href="#l72">72</a><td>// Exported to the global scope for legacy reasons.<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.exportSymbol(&#39;By&#39;, webdriver.By);<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Short-hand expressions for the primary element locator strategies.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * For example the following two statements are equivalent:<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> * var e1 = driver.findElement(webdriver.By.id(&#39;foo&#39;));<tr><td><a id="l81"></a><a href="#l81">81</a><td> * var e2 = driver.findElement({id: &#39;foo&#39;});<tr><td><a id="l82"></a><a href="#l82">82</a><td> *<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Care should be taken when using JavaScript minifiers (such as the<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Closure compiler), as locator hashes will always be parsed using<tr><td><a id="l85"></a><a href="#l85">85</a><td> * the un-obfuscated properties listed.<tr><td><a id="l86"></a><a href="#l86">86</a><td> *<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @typedef {(<tr><td><a id="l88"></a><a href="#l88">88</a><td> * {className: string}|<tr><td><a id="l89"></a><a href="#l89">89</a><td> * {css: string}|<tr><td><a id="l90"></a><a href="#l90">90</a><td> * {id: string}|<tr><td><a id="l91"></a><a href="#l91">91</a><td> * {js: string}|<tr><td><a id="l92"></a><a href="#l92">92</a><td> * {linkText: string}|<tr><td><a id="l93"></a><a href="#l93">93</a><td> * {name: string}|<tr><td><a id="l94"></a><a href="#l94">94</a><td> * {partialLinkText: string}|<tr><td><a id="l95"></a><a href="#l95">95</a><td> * {tagName: string}|<tr><td><a id="l96"></a><a href="#l96">96</a><td> * {xpath: string})}<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>webdriver.By.Hash;<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> * Locates elements that have a specific class name. The returned locator<tr><td><a id="l103"></a><a href="#l103">103</a><td> * is equivalent to searching for elements with the CSS selector &quot;.clazz&quot;.<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string} className The class name to search for.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @see http://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @see http://www.w3.org/TR/CSS2/selector.html#class-html<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>webdriver.By.className = webdriver.Locator.factory_(&#39;class name&#39;);<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Locates elements using a CSS selector. For browsers that do not support<tr><td><a id="l115"></a><a href="#l115">115</a><td> * CSS selectors, WebDriver implementations may return an<tr><td><a id="l116"></a><a href="#l116">116</a><td> * {@linkplain bot.Error.State.INVALID_SELECTOR invalid selector} error. An<tr><td><a id="l117"></a><a href="#l117">117</a><td> * implementation may, however, emulate the CSS selector API.<tr><td><a id="l118"></a><a href="#l118">118</a><td> *<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @param {string} selector The CSS selector to use.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @see http://www.w3.org/TR/CSS2/selector.html<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>webdriver.By.css = webdriver.Locator.factory_(&#39;css selector&#39;);<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>/**<tr><td><a id="l127"></a><a href="#l127">127</a><td> * Locates an element by its ID.<tr><td><a id="l128"></a><a href="#l128">128</a><td> *<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {string} id The ID to search for.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l131"></a><a href="#l131">131</a><td> */<tr><td><a id="l132"></a><a href="#l132">132</a><td>webdriver.By.id = webdriver.Locator.factory_(&#39;id&#39;);<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Locates link elements whose {@linkplain webdriver.WebElement#getText visible<tr><td><a id="l137"></a><a href="#l137">137</a><td> * text} matches the given string.<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {string} text The link text to search for.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>webdriver.By.linkText = webdriver.Locator.factory_(&#39;link text&#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> * Locates an elements by evaluating a<tr><td><a id="l147"></a><a href="#l147">147</a><td> * {@linkplain webdriver.WebDriver#executeScript JavaScript expression}.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * The result of this expression must be an element or list of elements.<tr><td><a id="l149"></a><a href="#l149">149</a><td> *<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @return {function(!webdriver.WebDriver): !webdriver.promise.Promise} A new,<tr><td><a id="l153"></a><a href="#l153">153</a><td> * JavaScript-based locator function.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>webdriver.By.js = function(script, var_args) {<tr><td><a id="l156"></a><a href="#l156">156</a><td> var args = goog.array.slice(arguments, 0);<tr><td><a id="l157"></a><a href="#l157">157</a><td> return function(driver) {<tr><td><a id="l158"></a><a href="#l158">158</a><td> return driver.executeScript.apply(driver, args);<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> * Locates elements whose {@code name} attribute has the given value.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string} name The name attribute to search for.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>webdriver.By.name = webdriver.Locator.factory_(&#39;name&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td><tr><td><a id="l172"></a><a href="#l172">172</a><td>/**<tr><td><a id="l173"></a><a href="#l173">173</a><td> * Locates link elements whose {@linkplain webdriver.WebElement#getText visible<tr><td><a id="l174"></a><a href="#l174">174</a><td> * text} contains the given substring.<tr><td><a id="l175"></a><a href="#l175">175</a><td> *<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>webdriver.By.partialLinkText = webdriver.Locator.factory_(<tr><td><a id="l180"></a><a href="#l180">180</a><td> &#39;partial link text&#39;);<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> * Locates elements with a given tag name. The returned locator is<tr><td><a id="l185"></a><a href="#l185">185</a><td> * equivalent to using the<tr><td><a id="l186"></a><a href="#l186">186</a><td> * [getElementsByTagName](https://developer.mozilla.org/en-US/docs/Web/API/Element.getElementsByTagName)<tr><td><a id="l187"></a><a href="#l187">187</a><td> * DOM function.<tr><td><a id="l188"></a><a href="#l188">188</a><td> *<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @see http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>webdriver.By.tagName = webdriver.Locator.factory_(&#39;tag name&#39;);<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>/**<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Locates elements matching a XPath selector. Care should be taken when<tr><td><a id="l198"></a><a href="#l198">198</a><td> * using an XPath selector with a {@link webdriver.WebElement} as WebDriver<tr><td><a id="l199"></a><a href="#l199">199</a><td> * will respect the context in the specified in the selector. For example,<tr><td><a id="l200"></a><a href="#l200">200</a><td> * given the selector {@code &quot;//div&quot;}, WebDriver will search from the<tr><td><a id="l201"></a><a href="#l201">201</a><td> * document root regardless of whether the locator was used with a<tr><td><a id="l202"></a><a href="#l202">202</a><td> * WebElement.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {string} xpath The XPath selector to use.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @see http://www.w3.org/TR/xpath/<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>webdriver.By.xpath = webdriver.Locator.factory_(&#39;xpath&#39;);<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> * Maps {@link webdriver.By.Hash} keys to the appropriate factory function.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @type {!Object.&lt;string, function(string): !(Function|webdriver.Locator)&gt;}<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @const<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>webdriver.Locator.Strategy = {<tr><td><a id="l217"></a><a href="#l217">217</a><td> &#39;className&#39;: webdriver.By.className,<tr><td><a id="l218"></a><a href="#l218">218</a><td> &#39;css&#39;: webdriver.By.css,<tr><td><a id="l219"></a><a href="#l219">219</a><td> &#39;id&#39;: webdriver.By.id,<tr><td><a id="l220"></a><a href="#l220">220</a><td> &#39;js&#39;: webdriver.By.js,<tr><td><a id="l221"></a><a href="#l221">221</a><td> &#39;linkText&#39;: webdriver.By.linkText,<tr><td><a id="l222"></a><a href="#l222">222</a><td> &#39;name&#39;: webdriver.By.name,<tr><td><a id="l223"></a><a href="#l223">223</a><td> &#39;partialLinkText&#39;: webdriver.By.partialLinkText,<tr><td><a id="l224"></a><a href="#l224">224</a><td> &#39;tagName&#39;: webdriver.By.tagName,<tr><td><a id="l225"></a><a href="#l225">225</a><td> &#39;xpath&#39;: webdriver.By.xpath<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * Verifies that a {@code value} is a valid locator to use for searching for<tr><td><a id="l231"></a><a href="#l231">231</a><td> * elements on the page.<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @param {*} value The value to check is a valid locator.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @return {!(webdriver.Locator|Function)} A valid locator object or function.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @throws {TypeError} If the given value is an invalid locator.<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>webdriver.Locator.checkLocator = function(value) {<tr><td><a id="l238"></a><a href="#l238">238</a><td> if (goog.isFunction(value) || value instanceof webdriver.Locator) {<tr><td><a id="l239"></a><a href="#l239">239</a><td> return value;<tr><td><a id="l240"></a><a href="#l240">240</a><td> }<tr><td><a id="l241"></a><a href="#l241">241</a><td> for (var key in value) {<tr><td><a id="l242"></a><a href="#l242">242</a><td> if (value.hasOwnProperty(key) &amp;&amp;<tr><td><a id="l243"></a><a href="#l243">243</a><td> webdriver.Locator.Strategy.hasOwnProperty(key)) {<tr><td><a id="l244"></a><a href="#l244">244</a><td> return webdriver.Locator.Strategy[key](value[key]);<tr><td><a id="l245"></a><a href="#l245">245</a><td> }<tr><td><a id="l246"></a><a href="#l246">246</a><td> }<tr><td><a id="l247"></a><a href="#l247">247</a><td> throw new TypeError(&#39;Invalid locator&#39;);<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td><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>/** @override */<tr><td><a id="l253"></a><a href="#l253">253</a><td>webdriver.Locator.prototype.toString = function() {<tr><td><a id="l254"></a><a href="#l254">254</a><td> return &#39;By.&#39; + this.using.replace(/ ([a-z])/g, function(all, match) {<tr><td><a id="l255"></a><a href="#l255">255</a><td> return match.toUpperCase();<tr><td><a id="l256"></a><a href="#l256">256</a><td> }) + &#39;(&#39; + goog.string.quote(this.value) + &#39;)&#39;;<tr><td><a id="l257"></a><a href="#l257">257</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>