selenium-webdriver 2.48.2 → 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 (524) hide show
  1. package/CHANGES.md +57 -0
  2. package/NOTICE +1 -1
  3. package/README.md +56 -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 +79 -87
  12. package/firefox/extension.js +10 -18
  13. package/firefox/index.js +173 -173
  14. package/firefox/profile.js +220 -240
  15. package/http/index.js +396 -79
  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} +88 -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 +5 -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/{webdriver/promise.js → promise.js} +688 -644
  34. package/lib/session.js +79 -0
  35. package/lib/{webdriver/serializable.js → symbols.js} +11 -16
  36. package/lib/test/build.js +4 -4
  37. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  38. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  39. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  40. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  41. package/lib/test/data/readOnlyPage.html +1 -1
  42. package/lib/test/data/selectPage.html +18 -2
  43. package/lib/test/fileserver.js +3 -4
  44. package/lib/test/index.js +7 -3
  45. package/lib/test/resources.js +1 -1
  46. package/lib/until.js +428 -0
  47. package/lib/webdriver.js +2351 -0
  48. package/net/portprober.js +15 -11
  49. package/opera.js +295 -314
  50. package/package.json +6 -5
  51. package/phantomjs.js +135 -140
  52. package/proxy.js +6 -4
  53. package/remote/index.js +229 -221
  54. package/safari.js +319 -310
  55. package/test/chrome/options_test.js +11 -9
  56. package/test/element_finding_test.js +51 -13
  57. package/test/error_test.js +163 -0
  58. package/test/execute_script_test.js +1 -1
  59. package/test/http/http_test.js +317 -55
  60. package/test/http/util_test.js +25 -23
  61. package/test/io_test.js +6 -1
  62. package/test/lib/by_test.js +127 -0
  63. package/test/lib/capabilities_test.js +84 -0
  64. package/test/lib/events_test.js +177 -0
  65. package/test/lib/logging_test.js +272 -0
  66. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  67. package/test/lib/promise_error_test.js +808 -0
  68. package/test/lib/promise_flow_test.js +2282 -0
  69. package/test/lib/promise_generator_test.js +308 -0
  70. package/test/lib/promise_test.js +996 -0
  71. package/test/lib/testutil.js +90 -0
  72. package/test/lib/until_test.js +436 -0
  73. package/test/lib/webdriver_test.js +2207 -0
  74. package/test/page_loading_test.js +7 -9
  75. package/test/stale_element_test.js +2 -2
  76. package/test/testing/assert_test.js +374 -0
  77. package/test/testing/index_test.js +9 -11
  78. package/testing/assert.js +334 -17
  79. package/testing/index.js +10 -0
  80. package/_base.js +0 -200
  81. package/docs/Changes.html +0 -356
  82. package/docs/class_bot_Error.html +0 -15
  83. package/docs/class_webdriver_ActionSequence.html +0 -115
  84. package/docs/class_webdriver_Alert.html +0 -24
  85. package/docs/class_webdriver_AlertPromise.html +0 -92
  86. package/docs/class_webdriver_Capabilities.html +0 -60
  87. package/docs/class_webdriver_Command.html +0 -15
  88. package/docs/class_webdriver_EventEmitter.html +0 -35
  89. package/docs/class_webdriver_FileDetector.html +0 -21
  90. package/docs/class_webdriver_Locator.html +0 -12
  91. package/docs/class_webdriver_Serializable.html +0 -9
  92. package/docs/class_webdriver_Session.html +0 -13
  93. package/docs/class_webdriver_TouchSequence.html +0 -49
  94. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  95. package/docs/class_webdriver_WebDriver.html +0 -313
  96. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  97. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  98. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  99. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  100. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  101. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  102. package/docs/class_webdriver_WebElement.html +0 -223
  103. package/docs/class_webdriver_WebElementPromise.html +0 -274
  104. package/docs/class_webdriver_http_Executor.html +0 -22
  105. package/docs/class_webdriver_http_Request.html +0 -12
  106. package/docs/class_webdriver_http_Response.html +0 -13
  107. package/docs/class_webdriver_logging_Entry.html +0 -15
  108. package/docs/class_webdriver_logging_Level.html +0 -55
  109. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  110. package/docs/class_webdriver_logging_Logger.html +0 -119
  111. package/docs/class_webdriver_logging_Preferences.html +0 -8
  112. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  113. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  114. package/docs/class_webdriver_promise_Deferred.html +0 -84
  115. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  116. package/docs/class_webdriver_promise_Promise.html +0 -75
  117. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  118. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  119. package/docs/class_webdriver_testing_Assertion.html +0 -99
  120. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  121. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  122. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  123. package/docs/class_webdriver_until_Condition.html +0 -7
  124. package/docs/dossier.css +0 -1
  125. package/docs/dossier.js +0 -86
  126. package/docs/enum_bot_ErrorCode.html +0 -3
  127. package/docs/enum_bot_Error_State.html +0 -2
  128. package/docs/enum_webdriver_Browser.html +0 -2
  129. package/docs/enum_webdriver_Button.html +0 -2
  130. package/docs/enum_webdriver_Capability.html +0 -33
  131. package/docs/enum_webdriver_CommandName.html +0 -3
  132. package/docs/enum_webdriver_Key.html +0 -12
  133. package/docs/enum_webdriver_logging_Type.html +0 -6
  134. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  135. package/docs/index.html +0 -125
  136. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  137. package/docs/interface_webdriver_http_Client.html +0 -10
  138. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  139. package/docs/module_selenium-webdriver.html +0 -23
  140. package/docs/module_selenium-webdriver__base.html +0 -23
  141. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  142. package/docs/module_selenium-webdriver_builder.html +0 -2
  143. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  144. package/docs/module_selenium-webdriver_chrome.html +0 -90
  145. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  146. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  147. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  148. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  149. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  150. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  151. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  152. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  153. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  154. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  155. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  156. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  157. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  158. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  159. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  160. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  161. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  162. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  163. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  164. package/docs/module_selenium-webdriver_error.html +0 -4
  165. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  166. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  167. package/docs/module_selenium-webdriver_executors.html +0 -10
  168. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  169. package/docs/module_selenium-webdriver_firefox.html +0 -68
  170. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  171. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  172. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  173. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  174. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  175. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  176. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  177. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  178. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_http.html +0 -9
  180. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  181. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  182. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  183. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  184. package/docs/module_selenium-webdriver_http_util.html +0 -17
  185. package/docs/module_selenium-webdriver_ie.html +0 -11
  186. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  187. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  188. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  189. package/docs/module_selenium-webdriver_io.html +0 -37
  190. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  191. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  192. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  193. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  194. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  195. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  196. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  197. package/docs/module_selenium-webdriver_net.html +0 -7
  198. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  199. package/docs/module_selenium-webdriver_opera.html +0 -62
  200. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  201. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  202. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  203. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  204. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  205. package/docs/module_selenium-webdriver_proxy.html +0 -28
  206. package/docs/module_selenium-webdriver_remote.html +0 -8
  207. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  208. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  209. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  210. package/docs/module_selenium-webdriver_safari.html +0 -9
  211. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  212. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  213. package/docs/module_selenium-webdriver_testing.html +0 -74
  214. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  215. package/docs/namespace_bot.html +0 -4
  216. package/docs/namespace_bot_json.html +0 -20
  217. package/docs/namespace_bot_response.html +0 -18
  218. package/docs/namespace_bot_userAgent.html +0 -33
  219. package/docs/namespace_webdriver.html +0 -30
  220. package/docs/namespace_webdriver_By.html +0 -56
  221. package/docs/namespace_webdriver_http.html +0 -6
  222. package/docs/namespace_webdriver_logging.html +0 -70
  223. package/docs/namespace_webdriver_promise.html +0 -688
  224. package/docs/namespace_webdriver_stacktrace.html +0 -17
  225. package/docs/namespace_webdriver_testing.html +0 -7
  226. package/docs/namespace_webdriver_testing_assert.html +0 -9
  227. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  228. package/docs/namespace_webdriver_until.html +0 -82
  229. package/docs/source/_base.js.src.html +0 -1
  230. package/docs/source/builder.js.src.html +0 -1
  231. package/docs/source/chrome.js.src.html +0 -1
  232. package/docs/source/error.js.src.html +0 -1
  233. package/docs/source/executors.js.src.html +0 -1
  234. package/docs/source/firefox/binary.js.src.html +0 -1
  235. package/docs/source/firefox/extension.js.src.html +0 -1
  236. package/docs/source/firefox/index.js.src.html +0 -1
  237. package/docs/source/firefox/profile.js.src.html +0 -1
  238. package/docs/source/http/index.js.src.html +0 -1
  239. package/docs/source/http/util.js.src.html +0 -1
  240. package/docs/source/ie.js.src.html +0 -1
  241. package/docs/source/index.js.src.html +0 -1
  242. package/docs/source/io/exec.js.src.html +0 -1
  243. package/docs/source/io/index.js.src.html +0 -1
  244. package/docs/source/lib/atoms/error.js.src.html +0 -1
  245. package/docs/source/lib/atoms/json.js.src.html +0 -1
  246. package/docs/source/lib/atoms/response.js.src.html +0 -1
  247. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  248. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  249. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  250. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  251. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  252. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  254. package/docs/source/lib/goog/base.js.src.html +0 -1
  255. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  256. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  257. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  261. package/docs/source/lib/goog/deps.js.src.html +0 -1
  262. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  263. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  264. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  265. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  266. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  271. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  272. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  273. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  282. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  283. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  284. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  285. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  286. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  291. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  292. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  293. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  294. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  295. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  296. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  304. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  305. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  306. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  310. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  311. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  314. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  315. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  316. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  318. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  319. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  320. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  322. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  323. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  326. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  327. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  328. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  344. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  345. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  346. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  347. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  348. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  349. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  350. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  351. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  366. package/docs/source/net/index.js.src.html +0 -1
  367. package/docs/source/net/portprober.js.src.html +0 -1
  368. package/docs/source/opera.js.src.html +0 -1
  369. package/docs/source/phantomjs.js.src.html +0 -1
  370. package/docs/source/proxy.js.src.html +0 -1
  371. package/docs/source/remote/index.js.src.html +0 -1
  372. package/docs/source/safari.js.src.html +0 -1
  373. package/docs/source/testing/assert.js.src.html +0 -1
  374. package/docs/source/testing/index.js.src.html +0 -1
  375. package/docs/types.js +0 -1
  376. package/lib/atoms/error.js +0 -202
  377. package/lib/atoms/json.js +0 -80
  378. package/lib/atoms/response.js +0 -110
  379. package/lib/atoms/userAgent.js +0 -257
  380. package/lib/goog/LICENSE +0 -176
  381. package/lib/goog/array/array.js +0 -1654
  382. package/lib/goog/asserts/asserts.js +0 -365
  383. package/lib/goog/async/freelist.js +0 -88
  384. package/lib/goog/async/nexttick.js +0 -241
  385. package/lib/goog/async/run.js +0 -133
  386. package/lib/goog/async/workqueue.js +0 -139
  387. package/lib/goog/base.js +0 -2548
  388. package/lib/goog/debug/debug.js +0 -653
  389. package/lib/goog/debug/entrypointregistry.js +0 -158
  390. package/lib/goog/debug/error.js +0 -63
  391. package/lib/goog/debug/logbuffer.js +0 -148
  392. package/lib/goog/debug/logger.js +0 -873
  393. package/lib/goog/debug/logrecord.js +0 -242
  394. package/lib/goog/deps.js +0 -151
  395. package/lib/goog/disposable/disposable.js +0 -307
  396. package/lib/goog/disposable/idisposable.js +0 -45
  397. package/lib/goog/dom/browserfeature.js +0 -72
  398. package/lib/goog/dom/dom.js +0 -2991
  399. package/lib/goog/dom/nodetype.js +0 -48
  400. package/lib/goog/dom/safe.js +0 -347
  401. package/lib/goog/dom/tagname.js +0 -160
  402. package/lib/goog/dom/tags.js +0 -41
  403. package/lib/goog/dom/vendor.js +0 -96
  404. package/lib/goog/events/browserevent.js +0 -400
  405. package/lib/goog/events/browserfeature.js +0 -85
  406. package/lib/goog/events/event.js +0 -143
  407. package/lib/goog/events/eventid.js +0 -47
  408. package/lib/goog/events/events.js +0 -984
  409. package/lib/goog/events/eventtarget.js +0 -394
  410. package/lib/goog/events/eventtype.js +0 -237
  411. package/lib/goog/events/keycodes.js +0 -427
  412. package/lib/goog/events/listenable.js +0 -335
  413. package/lib/goog/events/listener.js +0 -131
  414. package/lib/goog/events/listenermap.js +0 -308
  415. package/lib/goog/fs/url.js +0 -109
  416. package/lib/goog/functions/functions.js +0 -442
  417. package/lib/goog/html/safehtml.js +0 -757
  418. package/lib/goog/html/safescript.js +0 -234
  419. package/lib/goog/html/safestyle.js +0 -442
  420. package/lib/goog/html/safestylesheet.js +0 -276
  421. package/lib/goog/html/safeurl.js +0 -398
  422. package/lib/goog/html/trustedresourceurl.js +0 -224
  423. package/lib/goog/html/uncheckedconversions.js +0 -232
  424. package/lib/goog/i18n/bidi.js +0 -908
  425. package/lib/goog/iter/iter.js +0 -1302
  426. package/lib/goog/json/json.js +0 -363
  427. package/lib/goog/labs/testing/assertthat.js +0 -58
  428. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  429. package/lib/goog/labs/testing/matcher.js +0 -80
  430. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  431. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  432. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  433. package/lib/goog/labs/useragent/browser.js +0 -341
  434. package/lib/goog/labs/useragent/engine.js +0 -160
  435. package/lib/goog/labs/useragent/platform.js +0 -160
  436. package/lib/goog/labs/useragent/util.js +0 -148
  437. package/lib/goog/log/log.js +0 -197
  438. package/lib/goog/math/box.js +0 -398
  439. package/lib/goog/math/coordinate.js +0 -268
  440. package/lib/goog/math/math.js +0 -451
  441. package/lib/goog/math/rect.js +0 -476
  442. package/lib/goog/math/size.js +0 -227
  443. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  444. package/lib/goog/net/xhrlike.js +0 -124
  445. package/lib/goog/net/xmlhttp.js +0 -246
  446. package/lib/goog/net/xmlhttpfactory.js +0 -67
  447. package/lib/goog/object/object.js +0 -686
  448. package/lib/goog/promise/promise.js +0 -1350
  449. package/lib/goog/promise/resolver.js +0 -48
  450. package/lib/goog/promise/thenable.js +0 -126
  451. package/lib/goog/reflect/reflect.js +0 -77
  452. package/lib/goog/string/const.js +0 -182
  453. package/lib/goog/string/string.js +0 -1599
  454. package/lib/goog/string/typedstring.js +0 -48
  455. package/lib/goog/structs/collection.js +0 -56
  456. package/lib/goog/structs/map.js +0 -457
  457. package/lib/goog/structs/set.js +0 -279
  458. package/lib/goog/structs/structs.js +0 -354
  459. package/lib/goog/style/style.js +0 -2037
  460. package/lib/goog/testing/asserts.js +0 -1278
  461. package/lib/goog/testing/events/events.js +0 -767
  462. package/lib/goog/testing/functionmock.js +0 -175
  463. package/lib/goog/testing/jsunit.js +0 -162
  464. package/lib/goog/testing/loosemock.js +0 -242
  465. package/lib/goog/testing/mock.js +0 -645
  466. package/lib/goog/testing/mockclock.js +0 -606
  467. package/lib/goog/testing/mockcontrol.js +0 -220
  468. package/lib/goog/testing/mockinterface.js +0 -45
  469. package/lib/goog/testing/mockmatchers.js +0 -400
  470. package/lib/goog/testing/objectpropertystring.js +0 -68
  471. package/lib/goog/testing/propertyreplacer.js +0 -262
  472. package/lib/goog/testing/recordfunction.js +0 -215
  473. package/lib/goog/testing/stacktrace.js +0 -594
  474. package/lib/goog/testing/strictmock.js +0 -130
  475. package/lib/goog/testing/testcase.js +0 -1629
  476. package/lib/goog/testing/testrunner.js +0 -440
  477. package/lib/goog/uri/uri.js +0 -1524
  478. package/lib/goog/uri/utils.js +0 -1064
  479. package/lib/goog/useragent/product.js +0 -183
  480. package/lib/goog/useragent/product_isversion.js +0 -144
  481. package/lib/goog/useragent/useragent.js +0 -572
  482. package/lib/webdriver/actionsequence.js +0 -356
  483. package/lib/webdriver/builder.js +0 -207
  484. package/lib/webdriver/capabilities.js +0 -412
  485. package/lib/webdriver/events.js +0 -179
  486. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  487. package/lib/webdriver/http/corsclient.js +0 -133
  488. package/lib/webdriver/http/http.js +0 -525
  489. package/lib/webdriver/http/xhrclient.js +0 -67
  490. package/lib/webdriver/locators.js +0 -257
  491. package/lib/webdriver/logging.js +0 -347
  492. package/lib/webdriver/session.js +0 -74
  493. package/lib/webdriver/stacktrace.js +0 -619
  494. package/lib/webdriver/test/builder_test.js +0 -53
  495. package/lib/webdriver/test/capabilities_test.js +0 -72
  496. package/lib/webdriver/test/events_test.js +0 -203
  497. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  498. package/lib/webdriver/test/http/http_test.js +0 -428
  499. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  500. package/lib/webdriver/test/locators_test.js +0 -59
  501. package/lib/webdriver/test/logging_test.js +0 -85
  502. package/lib/webdriver/test/promise_error_test.js +0 -892
  503. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  504. package/lib/webdriver/test/promise_generator_test.js +0 -323
  505. package/lib/webdriver/test/promise_test.js +0 -2012
  506. package/lib/webdriver/test/stacktrace_test.js +0 -480
  507. package/lib/webdriver/test/test_bootstrap.js +0 -67
  508. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  509. package/lib/webdriver/test/testing/client_test.js +0 -88
  510. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  511. package/lib/webdriver/test/testutil.js +0 -209
  512. package/lib/webdriver/test/testutil_test.js +0 -104
  513. package/lib/webdriver/test/until_test.js +0 -411
  514. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  515. package/lib/webdriver/test/webdriver_test.js +0 -2369
  516. package/lib/webdriver/testing/asserts.js +0 -487
  517. package/lib/webdriver/testing/client.js +0 -179
  518. package/lib/webdriver/testing/jsunit.js +0 -363
  519. package/lib/webdriver/testing/testcase.js +0 -168
  520. package/lib/webdriver/testing/window.js +0 -244
  521. package/lib/webdriver/touchsequence.js +0 -248
  522. package/lib/webdriver/until.js +0 -412
  523. package/lib/webdriver/webdriver.js +0 -2511
  524. package/test/_base_test.js +0 -129
package/docs/source/lib/webdriver/serializable.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>serializable.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/serializable.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.Serializable&#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>/**<tr><td><a id="l23"></a><a href="#l23">23</a><td> * Defines an object that can be asynchronously serialized to its WebDriver<tr><td><a id="l24"></a><a href="#l24">24</a><td> * wire representation.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @constructor<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @template T<tr><td><a id="l28"></a><a href="#l28">28</a><td> */<tr><td><a id="l29"></a><a href="#l29">29</a><td>webdriver.Serializable = function() {};<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> * Returns either this instance&#39;s serialized represention, if immediately<tr><td><a id="l34"></a><a href="#l34">34</a><td> * available, or a promise for its serialized representation. This function is<tr><td><a id="l35"></a><a href="#l35">35</a><td> * conceptually equivalent to objects that have a {@code toJSON()} property,<tr><td><a id="l36"></a><a href="#l36">36</a><td> * except the serialize() result may be a promise or an object containing a<tr><td><a id="l37"></a><a href="#l37">37</a><td> * promise (which are not directly JSON friendly).<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @return {!(T|IThenable.&lt;!T&gt;)} This instance&#39;s serialized wire format.<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.Serializable.prototype.serialize = 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/session.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>session.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/session.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.Session&#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>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/**<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Contains information about a WebDriver session.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {string} id The session ID.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The session<tr><td><a id="l28"></a><a href="#l28">28</a><td> * capabilities.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @constructor<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td>webdriver.Session = function(id, capabilities) {<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td> /** @private {string} */<tr><td><a id="l34"></a><a href="#l34">34</a><td> this.id_ = id;<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td> /** @private {!webdriver.Capabilities} */<tr><td><a id="l37"></a><a href="#l37">37</a><td> this.caps_ = new webdriver.Capabilities().merge(capabilities);<tr><td><a id="l38"></a><a href="#l38">38</a><td>};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @return {string} This session&#39;s ID.<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>webdriver.Session.prototype.getId = function() {<tr><td><a id="l45"></a><a href="#l45">45</a><td> return this.id_;<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.Capabilities} This session&#39;s capabilities.<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.Session.prototype.getCapabilities = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td> return this.caps_;<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> * Retrieves the value of a specific capability.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string} key The capability to retrieve.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @return {*} The capability value.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>webdriver.Session.prototype.getCapability = function(key) {<tr><td><a id="l63"></a><a href="#l63">63</a><td> return this.caps_.get(key);<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 the JSON representation of this object, which is just the string<tr><td><a id="l69"></a><a href="#l69">69</a><td> * session ID.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {string} The JSON representation of this Session.<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>webdriver.Session.prototype.toJSON = function() {<tr><td><a id="l73"></a><a href="#l73">73</a><td> return this.getId();<tr><td><a id="l74"></a><a href="#l74">74</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/stacktrace.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>stacktrace.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/stacktrace.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 Tools for parsing and pretty printing error stack traces. This<tr><td><a id="l20"></a><a href="#l20">20</a><td> * file is based on goog.testing.stacktrace.<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.stacktrace&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.stacktrace.Snapshot&#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.string&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.userAgent&#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> * Stores a snapshot of the stack trace at the time this instance was created.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * The stack trace will always be adjusted to exclude this function call.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {number=} opt_slice The number of frames to remove from the top of<tr><td><a id="l36"></a><a href="#l36">36</a><td> * the generated stack trace.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @constructor<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>webdriver.stacktrace.Snapshot = function(opt_slice) {<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td> /** @private {number} */<tr><td><a id="l42"></a><a href="#l42">42</a><td> this.slice_ = opt_slice || 0;<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td> var error;<tr><td><a id="l45"></a><a href="#l45">45</a><td> if (webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_) {<tr><td><a id="l46"></a><a href="#l46">46</a><td> error = Error();<tr><td><a id="l47"></a><a href="#l47">47</a><td> Error.captureStackTrace(error, webdriver.stacktrace.Snapshot);<tr><td><a id="l48"></a><a href="#l48">48</a><td> } else {<tr><td><a id="l49"></a><a href="#l49">49</a><td> // Remove 1 extra frame for the call to this constructor.<tr><td><a id="l50"></a><a href="#l50">50</a><td> this.slice_ += 1;<tr><td><a id="l51"></a><a href="#l51">51</a><td> // IE will only create a stack trace when the Error is thrown.<tr><td><a id="l52"></a><a href="#l52">52</a><td> // We use null.x() to throw an exception instead of throw this.error_<tr><td><a id="l53"></a><a href="#l53">53</a><td> // because the closure compiler may optimize throws to a function call<tr><td><a id="l54"></a><a href="#l54">54</a><td> // in an attempt to minimize the binary size which in turn has the side<tr><td><a id="l55"></a><a href="#l55">55</a><td> // effect of adding an unwanted stack frame.<tr><td><a id="l56"></a><a href="#l56">56</a><td> try {<tr><td><a id="l57"></a><a href="#l57">57</a><td> null.x();<tr><td><a id="l58"></a><a href="#l58">58</a><td> } catch (e) {<tr><td><a id="l59"></a><a href="#l59">59</a><td> error = e;<tr><td><a id="l60"></a><a href="#l60">60</a><td> }<tr><td><a id="l61"></a><a href="#l61">61</a><td> }<tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td> /**<tr><td><a id="l64"></a><a href="#l64">64</a><td> * The error&#39;s stacktrace.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @private {string}<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td> this.stack_ = webdriver.stacktrace.getStack(error);<tr><td><a id="l68"></a><a href="#l68">68</a><td>};<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>/**<tr><td><a id="l72"></a><a href="#l72">72</a><td> * Whether the current environment supports the Error.captureStackTrace<tr><td><a id="l73"></a><a href="#l73">73</a><td> * function (as of 10/17/2012, only V8).<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @private {boolean}<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @const<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td>webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ =<tr><td><a id="l78"></a><a href="#l78">78</a><td> goog.isFunction(Error.captureStackTrace);<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Whether the current browser supports stack traces.<tr><td><a id="l83"></a><a href="#l83">83</a><td> *<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @type {boolean}<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @const<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>webdriver.stacktrace.BROWSER_SUPPORTED =<tr><td><a id="l88"></a><a href="#l88">88</a><td> webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ || (function() {<tr><td><a id="l89"></a><a href="#l89">89</a><td> try {<tr><td><a id="l90"></a><a href="#l90">90</a><td> throw Error();<tr><td><a id="l91"></a><a href="#l91">91</a><td> } catch (e) {<tr><td><a id="l92"></a><a href="#l92">92</a><td> return !!e.stack;<tr><td><a id="l93"></a><a href="#l93">93</a><td> }<tr><td><a id="l94"></a><a href="#l94">94</a><td> })();<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * The parsed stack trace. This list is lazily generated the first time it is<tr><td><a id="l99"></a><a href="#l99">99</a><td> * accessed.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private {Array.&lt;!webdriver.stacktrace.Frame&gt;}<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.stacktrace.Snapshot.prototype.parsedStack_ = null;<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td><tr><td><a id="l105"></a><a href="#l105">105</a><td>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The parsed stack trace.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>webdriver.stacktrace.Snapshot.prototype.getStacktrace = function() {<tr><td><a id="l109"></a><a href="#l109">109</a><td> if (goog.isNull(this.parsedStack_)) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> this.parsedStack_ = webdriver.stacktrace.parse_(this.stack_);<tr><td><a id="l111"></a><a href="#l111">111</a><td> if (this.slice_) {<tr><td><a id="l112"></a><a href="#l112">112</a><td> this.parsedStack_ = goog.array.slice(this.parsedStack_, this.slice_);<tr><td><a id="l113"></a><a href="#l113">113</a><td> }<tr><td><a id="l114"></a><a href="#l114">114</a><td> delete this.slice_;<tr><td><a id="l115"></a><a href="#l115">115</a><td> delete this.stack_;<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td> return this.parsedStack_;<tr><td><a id="l118"></a><a href="#l118">118</a><td>};<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>/**<tr><td><a id="l123"></a><a href="#l123">123</a><td> * Class representing one stack frame.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {(string|undefined)} context Context object, empty in case of global<tr><td><a id="l125"></a><a href="#l125">125</a><td> * functions or if the browser doesn&#39;t provide this information.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {(string|undefined)} name Function name, empty in case of anonymous<tr><td><a id="l127"></a><a href="#l127">127</a><td> * functions.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {(string|undefined)} alias Alias of the function if available. For<tr><td><a id="l129"></a><a href="#l129">129</a><td> * example the function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the<tr><td><a id="l130"></a><a href="#l130">130</a><td> * function is defined as &lt;code&gt;a.b = function c() {};&lt;/code&gt;.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {(string|undefined)} path File path or URL including line number and<tr><td><a id="l132"></a><a href="#l132">132</a><td> * optionally column number separated by colons.<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @constructor<tr><td><a id="l134"></a><a href="#l134">134</a><td> */<tr><td><a id="l135"></a><a href="#l135">135</a><td>webdriver.stacktrace.Frame = function(context, name, alias, path) {<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td> /** @private {string} */<tr><td><a id="l138"></a><a href="#l138">138</a><td> this.context_ = context || &#39;&#39;;<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td> /** @private {string} */<tr><td><a id="l141"></a><a href="#l141">141</a><td> this.name_ = name || &#39;&#39;;<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td> /** @private {string} */<tr><td><a id="l144"></a><a href="#l144">144</a><td> this.alias_ = alias || &#39;&#39;;<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td> /** @private {string} */<tr><td><a id="l147"></a><a href="#l147">147</a><td> this.path_ = path || &#39;&#39;;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td> /** @private {string} */<tr><td><a id="l150"></a><a href="#l150">150</a><td> this.url_ = this.path_;<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td> /** @private {number} */<tr><td><a id="l153"></a><a href="#l153">153</a><td> this.line_ = -1;<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td> /** @private {number} */<tr><td><a id="l156"></a><a href="#l156">156</a><td> this.column_ = -1;<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td> if (path) {<tr><td><a id="l159"></a><a href="#l159">159</a><td> var match = /:(\d+)(?::(\d+))?$/.exec(path);<tr><td><a id="l160"></a><a href="#l160">160</a><td> if (match) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> this.line_ = Number(match[1]);<tr><td><a id="l162"></a><a href="#l162">162</a><td> this.column = Number(match[2] || -1);<tr><td><a id="l163"></a><a href="#l163">163</a><td> this.url_ = path.substr(0, match.index);<tr><td><a id="l164"></a><a href="#l164">164</a><td> }<tr><td><a id="l165"></a><a href="#l165">165</a><td> }<tr><td><a id="l166"></a><a href="#l166">166</a><td>};<tr><td><a id="l167"></a><a href="#l167">167</a><td><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> * Constant for an anonymous frame.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @private {!webdriver.stacktrace.Frame}<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @const<tr><td><a id="l173"></a><a href="#l173">173</a><td> */<tr><td><a id="l174"></a><a href="#l174">174</a><td>webdriver.stacktrace.ANONYMOUS_FRAME_ =<tr><td><a id="l175"></a><a href="#l175">175</a><td> new webdriver.stacktrace.Frame(&#39;&#39;, &#39;&#39;, &#39;&#39;, &#39;&#39;);<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>/**<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @return {string} The function name or empty string if the function is<tr><td><a id="l180"></a><a href="#l180">180</a><td> * anonymous and the object field which it&#39;s assigned to is unknown.<tr><td><a id="l181"></a><a href="#l181">181</a><td> */<tr><td><a id="l182"></a><a href="#l182">182</a><td>webdriver.stacktrace.Frame.prototype.getName = function() {<tr><td><a id="l183"></a><a href="#l183">183</a><td> return this.name_;<tr><td><a id="l184"></a><a href="#l184">184</a><td>};<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td>/**<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {string} The url or empty string if it is unknown.<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>webdriver.stacktrace.Frame.prototype.getUrl = function() {<tr><td><a id="l191"></a><a href="#l191">191</a><td> return this.url_;<tr><td><a id="l192"></a><a href="#l192">192</a><td>};<tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @return {number} The line number if known or -1 if it is unknown.<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>webdriver.stacktrace.Frame.prototype.getLine = function() {<tr><td><a id="l199"></a><a href="#l199">199</a><td> return this.line_;<tr><td><a id="l200"></a><a href="#l200">200</a><td>};<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>/**<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @return {number} The column number if known and -1 if it is unknown.<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>webdriver.stacktrace.Frame.prototype.getColumn = function() {<tr><td><a id="l207"></a><a href="#l207">207</a><td> return this.column_;<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @return {boolean} Whether the stack frame contains an anonymous function.<tr><td><a id="l213"></a><a href="#l213">213</a><td> */<tr><td><a id="l214"></a><a href="#l214">214</a><td>webdriver.stacktrace.Frame.prototype.isAnonymous = function() {<tr><td><a id="l215"></a><a href="#l215">215</a><td> return !this.name_ || this.context_ == &#39;[object Object]&#39;;<tr><td><a id="l216"></a><a href="#l216">216</a><td>};<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td><tr><td><a id="l219"></a><a href="#l219">219</a><td>/**<tr><td><a id="l220"></a><a href="#l220">220</a><td> * Converts this frame to its string representation using V8&#39;s stack trace<tr><td><a id="l221"></a><a href="#l221">221</a><td> * format: http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @return {string} The string representation of this frame.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @override<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>webdriver.stacktrace.Frame.prototype.toString = function() {<tr><td><a id="l226"></a><a href="#l226">226</a><td> var context = this.context_;<tr><td><a id="l227"></a><a href="#l227">227</a><td> if (context &amp;&amp; context !== &#39;new &#39;) {<tr><td><a id="l228"></a><a href="#l228">228</a><td> context += &#39;.&#39;;<tr><td><a id="l229"></a><a href="#l229">229</a><td> }<tr><td><a id="l230"></a><a href="#l230">230</a><td> context += this.name_;<tr><td><a id="l231"></a><a href="#l231">231</a><td> context += this.alias_ ? &#39; [as &#39; + this.alias_ + &#39;]&#39; : &#39;&#39;;<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td> var path = this.path_ || &#39;&lt;anonymous&gt;&#39;;<tr><td><a id="l234"></a><a href="#l234">234</a><td> return &#39; at &#39; + (context ? context + &#39; (&#39; + path + &#39;)&#39; : path);<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>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Maximum length of a string that can be matched with a RegExp on<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Firefox 3x. Exceeding this approximate length will cause string.match<tr><td><a id="l241"></a><a href="#l241">241</a><td> * to exceed Firefox&#39;s stack quota. This situation can be encountered<tr><td><a id="l242"></a><a href="#l242">242</a><td> * when goog.globalEval is invoked with a long argument; such as<tr><td><a id="l243"></a><a href="#l243">243</a><td> * when loading a module.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @private {number}<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @const<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;<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> * RegExp pattern for JavaScript identifiers. We don&#39;t support Unicode<tr><td><a id="l252"></a><a href="#l252">252</a><td> * identifiers defined in ECMAScript v3.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @private {string}<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @const<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>webdriver.stacktrace.IDENTIFIER_PATTERN_ = &#39;[a-zA-Z_$][\\w$]*&#39;;<tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Pattern for a matching the type on a fully-qualified name. Forms an<tr><td><a id="l261"></a><a href="#l261">261</a><td> * optional sub-match on the type. For example, in &quot;foo.bar.baz&quot;, will match on<tr><td><a id="l262"></a><a href="#l262">262</a><td> * &quot;foo.bar&quot;.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @private {string}<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @const<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>webdriver.stacktrace.CONTEXT_PATTERN_ =<tr><td><a id="l267"></a><a href="#l267">267</a><td> &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l268"></a><a href="#l268">268</a><td> &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.&#39;;<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * Pattern for matching a fully qualified name. Will create two sub-matches:<tr><td><a id="l273"></a><a href="#l273">273</a><td> * the type (optional), and the name. For example, in &quot;foo.bar.baz&quot;, will<tr><td><a id="l274"></a><a href="#l274">274</a><td> * match on [&quot;foo.bar&quot;, &quot;baz&quot;].<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @private {string}<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @const<tr><td><a id="l277"></a><a href="#l277">277</a><td> */<tr><td><a id="l278"></a><a href="#l278">278</a><td>webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ =<tr><td><a id="l279"></a><a href="#l279">279</a><td> &#39;(?:&#39; + webdriver.stacktrace.CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l280"></a><a href="#l280">280</a><td> &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)&#39;;<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td>/**<tr><td><a id="l284"></a><a href="#l284">284</a><td> * RegExp pattern for function name alias in the V8 stack trace.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @private {string}<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @const<tr><td><a id="l287"></a><a href="#l287">287</a><td> */<tr><td><a id="l288"></a><a href="#l288">288</a><td>webdriver.stacktrace.V8_ALIAS_PATTERN_ =<tr><td><a id="l289"></a><a href="#l289">289</a><td> &#39;(?: \\[as (&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)\\])?&#39;;<tr><td><a id="l290"></a><a href="#l290">290</a><td><tr><td><a id="l291"></a><a href="#l291">291</a><td><tr><td><a id="l292"></a><a href="#l292">292</a><td>/**<tr><td><a id="l293"></a><a href="#l293">293</a><td> * RegExp pattern for function names and constructor calls in the V8 stack<tr><td><a id="l294"></a><a href="#l294">294</a><td> * trace.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @private {string}<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @const<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l299"></a><a href="#l299">299</a><td> &#39;(?:&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;|&lt;anonymous&gt;)&#39;;<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * RegExp pattern for the context of a function call in V8. Creates two<tr><td><a id="l304"></a><a href="#l304">304</a><td> * submatches, only one of which will ever match: either the namespace<tr><td><a id="l305"></a><a href="#l305">305</a><td> * identifier (with optional &quot;new&quot; keyword in the case of a constructor call),<tr><td><a id="l306"></a><a href="#l306">306</a><td> * or just the &quot;new &quot; phrase for a top level constructor call.<tr><td><a id="l307"></a><a href="#l307">307</a><td> * @private {string}<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @const<tr><td><a id="l309"></a><a href="#l309">309</a><td> */<tr><td><a id="l310"></a><a href="#l310">310</a><td>webdriver.stacktrace.V8_CONTEXT_PATTERN_ =<tr><td><a id="l311"></a><a href="#l311">311</a><td> &#39;(?:((?:new )?(?:\\[object Object\\]|&#39; +<tr><td><a id="l312"></a><a href="#l312">312</a><td> webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l313"></a><a href="#l313">313</a><td> &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)&#39; +<tr><td><a id="l314"></a><a href="#l314">314</a><td> &#39;)\\.|(new ))&#39;;<tr><td><a id="l315"></a><a href="#l315">315</a><td><tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>/**<tr><td><a id="l318"></a><a href="#l318">318</a><td> * RegExp pattern for function call in the V8 stack trace.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Creates 3 submatches with context object (optional), function name and<tr><td><a id="l320"></a><a href="#l320">320</a><td> * function alias (optional).<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @private {string}<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @const<tr><td><a id="l323"></a><a href="#l323">323</a><td> */<tr><td><a id="l324"></a><a href="#l324">324</a><td>webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l325"></a><a href="#l325">325</a><td> &#39; (?:&#39; + webdriver.stacktrace.V8_CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l326"></a><a href="#l326">326</a><td> &#39;(&#39; + webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ + &#39;)&#39; +<tr><td><a id="l327"></a><a href="#l327">327</a><td> webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * RegExp pattern for an URL + position inside the file.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @private {string}<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @const<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>webdriver.stacktrace.URL_PATTERN_ =<tr><td><a id="l336"></a><a href="#l336">336</a><td> &#39;((?:http|https|file)://[^\\s]+|javascript:.*)&#39;;<tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td>/**<tr><td><a id="l340"></a><a href="#l340">340</a><td> * RegExp pattern for a location string in a V8 stack frame. Creates two<tr><td><a id="l341"></a><a href="#l341">341</a><td> * submatches for the location, one for enclosed in parentheticals and on<tr><td><a id="l342"></a><a href="#l342">342</a><td> * where the location appears alone (which will only occur if the location is<tr><td><a id="l343"></a><a href="#l343">343</a><td> * the only information in the frame).<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @private {string}<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @const<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @see http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>webdriver.stacktrace.V8_LOCATION_PATTERN_ = &#39; (?:\\((.*)\\)|(.*))&#39;;<tr><td><a id="l349"></a><a href="#l349">349</a><td><tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td>/**<tr><td><a id="l352"></a><a href="#l352">352</a><td> * Regular expression for parsing one stack frame in V8.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @private {!RegExp}<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @const<tr><td><a id="l355"></a><a href="#l355">355</a><td> */<tr><td><a id="l356"></a><a href="#l356">356</a><td>webdriver.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp(&#39;^\\s+at&#39; +<tr><td><a id="l357"></a><a href="#l357">357</a><td> // Prevent intersections with IE10 stack frame regex.<tr><td><a id="l358"></a><a href="#l358">358</a><td> &#39;(?! (?:Anonymous function|Global code|eval code) )&#39; +<tr><td><a id="l359"></a><a href="#l359">359</a><td> &#39;(?:&#39; + webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l360"></a><a href="#l360">360</a><td> webdriver.stacktrace.V8_LOCATION_PATTERN_ + &#39;$&#39;);<tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td><tr><td><a id="l363"></a><a href="#l363">363</a><td>/**<tr><td><a id="l364"></a><a href="#l364">364</a><td> * RegExp pattern for function names in the Firefox stack trace.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * Firefox has extended identifiers to deal with inner functions and anonymous<tr><td><a id="l366"></a><a href="#l366">366</a><td> * functions: https://bugzilla.mozilla.org/show_bug.cgi?id=433529#c9<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @private {string}<tr><td><a id="l368"></a><a href="#l368">368</a><td> * @const<tr><td><a id="l369"></a><a href="#l369">369</a><td> */<tr><td><a id="l370"></a><a href="#l370">370</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l371"></a><a href="#l371">371</a><td> webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;[\\w./&lt;$]*&#39;;<tr><td><a id="l372"></a><a href="#l372">372</a><td><tr><td><a id="l373"></a><a href="#l373">373</a><td><tr><td><a id="l374"></a><a href="#l374">374</a><td>/**<tr><td><a id="l375"></a><a href="#l375">375</a><td> * RegExp pattern for function call in the Firefox stack trace.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * Creates a submatch for the function name.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * @private {string}<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @const<tr><td><a id="l379"></a><a href="#l379">379</a><td> */<tr><td><a id="l380"></a><a href="#l380">380</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l381"></a><a href="#l381">381</a><td> &#39;(&#39; + webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l382"></a><a href="#l382">382</a><td> &#39;(?:\\(.*\\))?@&#39;;<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td>/**<tr><td><a id="l386"></a><a href="#l386">386</a><td> * Regular expression for parsing one stack frame in Firefox.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @private {!RegExp}<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @const<tr><td><a id="l389"></a><a href="#l389">389</a><td> */<tr><td><a id="l390"></a><a href="#l390">390</a><td>webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l391"></a><a href="#l391">391</a><td> webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l392"></a><a href="#l392">392</a><td> &#39;(?::0|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)$&#39;);<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>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * RegExp pattern for function call in a Chakra (IE) stack trace. This<tr><td><a id="l397"></a><a href="#l397">397</a><td> * expression creates 2 submatches on the (optional) context and function name,<tr><td><a id="l398"></a><a href="#l398">398</a><td> * matching identifiers like &#39;foo.Bar.prototype.baz&#39;, &#39;Anonymous function&#39;,<tr><td><a id="l399"></a><a href="#l399">399</a><td> * &#39;eval code&#39;, and &#39;Global code&#39;.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @private {string}<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @const<tr><td><a id="l402"></a><a href="#l402">402</a><td> */<tr><td><a id="l403"></a><a href="#l403">403</a><td>webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l404"></a><a href="#l404">404</a><td> &#39;(?:(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l405"></a><a href="#l405">405</a><td> &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.)?&#39; +<tr><td><a id="l406"></a><a href="#l406">406</a><td> &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;(?:\\s+\\w+)*)&#39;;<tr><td><a id="l407"></a><a href="#l407">407</a><td><tr><td><a id="l408"></a><a href="#l408">408</a><td><tr><td><a id="l409"></a><a href="#l409">409</a><td>/**<tr><td><a id="l410"></a><a href="#l410">410</a><td> * Regular expression for parsing on stack frame in Chakra (IE).<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @private {!RegExp}<tr><td><a id="l412"></a><a href="#l412">412</a><td> * @const<tr><td><a id="l413"></a><a href="#l413">413</a><td> */<tr><td><a id="l414"></a><a href="#l414">414</a><td>webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^ at &#39; +<tr><td><a id="l415"></a><a href="#l415">415</a><td> webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l416"></a><a href="#l416">416</a><td> &#39;\\s*(?:\\((.*)\\))$&#39;);<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>/**<tr><td><a id="l420"></a><a href="#l420">420</a><td> * Placeholder for an unparsable frame in a stack trace generated by<tr><td><a id="l421"></a><a href="#l421">421</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l422"></a><a href="#l422">422</a><td> * @private {string}<tr><td><a id="l423"></a><a href="#l423">423</a><td> * @const<tr><td><a id="l424"></a><a href="#l424">424</a><td> */<tr><td><a id="l425"></a><a href="#l425">425</a><td>webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ = &#39;&gt; (unknown)&#39;;<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>/**<tr><td><a id="l429"></a><a href="#l429">429</a><td> * Representation of an anonymous frame in a stack trace generated by<tr><td><a id="l430"></a><a href="#l430">430</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l431"></a><a href="#l431">431</a><td> * @private {string}<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @const<tr><td><a id="l433"></a><a href="#l433">433</a><td> */<tr><td><a id="l434"></a><a href="#l434">434</a><td>webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_ = &#39;&gt; anonymous&#39;;<tr><td><a id="l435"></a><a href="#l435">435</a><td><tr><td><a id="l436"></a><a href="#l436">436</a><td><tr><td><a id="l437"></a><a href="#l437">437</a><td>/**<tr><td><a id="l438"></a><a href="#l438">438</a><td> * Pattern for a function call in a Closure stack trace. Creates three optional<tr><td><a id="l439"></a><a href="#l439">439</a><td> * submatches: the context, function name, and alias.<tr><td><a id="l440"></a><a href="#l440">440</a><td> * @private {string}<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @const<tr><td><a id="l442"></a><a href="#l442">442</a><td> */<tr><td><a id="l443"></a><a href="#l443">443</a><td>webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l444"></a><a href="#l444">444</a><td> webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ +<tr><td><a id="l445"></a><a href="#l445">445</a><td> &#39;(?:\\(.*\\))?&#39; + // Ignore arguments if present.<tr><td><a id="l446"></a><a href="#l446">446</a><td> webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l447"></a><a href="#l447">447</a><td><tr><td><a id="l448"></a><a href="#l448">448</a><td><tr><td><a id="l449"></a><a href="#l449">449</a><td>/**<tr><td><a id="l450"></a><a href="#l450">450</a><td> * Regular expression for parsing a stack frame generated by Closure&#39;s<tr><td><a id="l451"></a><a href="#l451">451</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l452"></a><a href="#l452">452</a><td> * @private {!RegExp}<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @const<tr><td><a id="l454"></a><a href="#l454">454</a><td> */<tr><td><a id="l455"></a><a href="#l455">455</a><td>webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&gt; &#39; +<tr><td><a id="l456"></a><a href="#l456">456</a><td> &#39;(?:&#39; + webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l457"></a><a href="#l457">457</a><td> &#39;(?: at )?)?&#39; +<tr><td><a id="l458"></a><a href="#l458">458</a><td> &#39;(?:(.*:\\d+:\\d+)|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)?$&#39;);<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>/**<tr><td><a id="l462"></a><a href="#l462">462</a><td> * Parses one stack frame.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @return {webdriver.stacktrace.Frame} Stack frame object or null if the<tr><td><a id="l465"></a><a href="#l465">465</a><td> * parsing failed.<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @private<tr><td><a id="l467"></a><a href="#l467">467</a><td> */<tr><td><a id="l468"></a><a href="#l468">468</a><td>webdriver.stacktrace.parseStackFrame_ = function(frameStr) {<tr><td><a id="l469"></a><a href="#l469">469</a><td> var m = frameStr.match(webdriver.stacktrace.V8_STACK_FRAME_REGEXP_);<tr><td><a id="l470"></a><a href="#l470">470</a><td> if (m) {<tr><td><a id="l471"></a><a href="#l471">471</a><td> return new webdriver.stacktrace.Frame(<tr><td><a id="l472"></a><a href="#l472">472</a><td> m[1] || m[2], m[3], m[4], m[5] || m[6]);<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> if (frameStr.length &gt;<tr><td><a id="l476"></a><a href="#l476">476</a><td> webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {<tr><td><a id="l477"></a><a href="#l477">477</a><td> return webdriver.stacktrace.parseLongFirefoxFrame_(frameStr);<tr><td><a id="l478"></a><a href="#l478">478</a><td> }<tr><td><a id="l479"></a><a href="#l479">479</a><td><tr><td><a id="l480"></a><a href="#l480">480</a><td> m = frameStr.match(webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);<tr><td><a id="l481"></a><a href="#l481">481</a><td> if (m) {<tr><td><a id="l482"></a><a href="#l482">482</a><td> return new webdriver.stacktrace.Frame(&#39;&#39;, m[1], &#39;&#39;, m[2]);<tr><td><a id="l483"></a><a href="#l483">483</a><td> }<tr><td><a id="l484"></a><a href="#l484">484</a><td><tr><td><a id="l485"></a><a href="#l485">485</a><td> m = frameStr.match(webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_);<tr><td><a id="l486"></a><a href="#l486">486</a><td> if (m) {<tr><td><a id="l487"></a><a href="#l487">487</a><td> return new webdriver.stacktrace.Frame(m[1], m[2], &#39;&#39;, m[3]);<tr><td><a id="l488"></a><a href="#l488">488</a><td> }<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td> if (frameStr == webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ ||<tr><td><a id="l491"></a><a href="#l491">491</a><td> frameStr == webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_) {<tr><td><a id="l492"></a><a href="#l492">492</a><td> return webdriver.stacktrace.ANONYMOUS_FRAME_;<tr><td><a id="l493"></a><a href="#l493">493</a><td> }<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td> m = frameStr.match(webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_);<tr><td><a id="l496"></a><a href="#l496">496</a><td> if (m) {<tr><td><a id="l497"></a><a href="#l497">497</a><td> return new webdriver.stacktrace.Frame(m[1], m[2], m[3], m[4] || m[5]);<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> return null;<tr><td><a id="l501"></a><a href="#l501">501</a><td>};<tr><td><a id="l502"></a><a href="#l502">502</a><td><tr><td><a id="l503"></a><a href="#l503">503</a><td><tr><td><a id="l504"></a><a href="#l504">504</a><td>/**<tr><td><a id="l505"></a><a href="#l505">505</a><td> * Parses a long firefox stack frame.<tr><td><a id="l506"></a><a href="#l506">506</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l507"></a><a href="#l507">507</a><td> * @return {!webdriver.stacktrace.Frame} Stack frame object.<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @private<tr><td><a id="l509"></a><a href="#l509">509</a><td> */<tr><td><a id="l510"></a><a href="#l510">510</a><td>webdriver.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {<tr><td><a id="l511"></a><a href="#l511">511</a><td> var firstParen = frameStr.indexOf(&#39;(&#39;);<tr><td><a id="l512"></a><a href="#l512">512</a><td> var lastAmpersand = frameStr.lastIndexOf(&#39;@&#39;);<tr><td><a id="l513"></a><a href="#l513">513</a><td> var lastColon = frameStr.lastIndexOf(&#39;:&#39;);<tr><td><a id="l514"></a><a href="#l514">514</a><td> var functionName = &#39;&#39;;<tr><td><a id="l515"></a><a href="#l515">515</a><td> if ((firstParen &gt;= 0) &amp;&amp; (firstParen &lt; lastAmpersand)) {<tr><td><a id="l516"></a><a href="#l516">516</a><td> functionName = frameStr.substring(0, firstParen);<tr><td><a id="l517"></a><a href="#l517">517</a><td> }<tr><td><a id="l518"></a><a href="#l518">518</a><td> var loc = &#39;&#39;;<tr><td><a id="l519"></a><a href="#l519">519</a><td> if ((lastAmpersand &gt;= 0) &amp;&amp; (lastAmpersand + 1 &lt; lastColon)) {<tr><td><a id="l520"></a><a href="#l520">520</a><td> loc = frameStr.substring(lastAmpersand + 1);<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 new webdriver.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, loc);<tr><td><a id="l523"></a><a href="#l523">523</a><td>};<tr><td><a id="l524"></a><a href="#l524">524</a><td><tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td>/**<tr><td><a id="l527"></a><a href="#l527">527</a><td> * Get an error&#39;s stack trace with the error string trimmed.<tr><td><a id="l528"></a><a href="#l528">528</a><td> * V8 prepends the string representation of an error to its stack trace.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * This function trims the string so that the stack trace can be parsed<tr><td><a id="l530"></a><a href="#l530">530</a><td> * consistently with the other JS engines.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @param {(Error|goog.testing.JsUnitException)} error The error.<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @return {string} The stack trace string.<tr><td><a id="l533"></a><a href="#l533">533</a><td> */<tr><td><a id="l534"></a><a href="#l534">534</a><td>webdriver.stacktrace.getStack = function(error) {<tr><td><a id="l535"></a><a href="#l535">535</a><td> if (!error) {<tr><td><a id="l536"></a><a href="#l536">536</a><td> return &#39;&#39;;<tr><td><a id="l537"></a><a href="#l537">537</a><td> }<tr><td><a id="l538"></a><a href="#l538">538</a><td> var stack = error.stack || error.stackTrace || &#39;&#39;;<tr><td><a id="l539"></a><a href="#l539">539</a><td> var errorStr = error + &#39;\n&#39;;<tr><td><a id="l540"></a><a href="#l540">540</a><td> if (goog.string.startsWith(stack, errorStr)) {<tr><td><a id="l541"></a><a href="#l541">541</a><td> stack = stack.substring(errorStr.length);<tr><td><a id="l542"></a><a href="#l542">542</a><td> }<tr><td><a id="l543"></a><a href="#l543">543</a><td> return stack;<tr><td><a id="l544"></a><a href="#l544">544</a><td>};<tr><td><a id="l545"></a><a href="#l545">545</a><td><tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td>/**<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Formats an error&#39;s stack trace.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @param {!(Error|goog.testing.JsUnitException)} error The error to format.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @return {!(Error|goog.testing.JsUnitException)} The formatted error.<tr><td><a id="l551"></a><a href="#l551">551</a><td> */<tr><td><a id="l552"></a><a href="#l552">552</a><td>webdriver.stacktrace.format = function(error) {<tr><td><a id="l553"></a><a href="#l553">553</a><td> var stack = webdriver.stacktrace.getStack(error);<tr><td><a id="l554"></a><a href="#l554">554</a><td> var frames = webdriver.stacktrace.parse_(stack);<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td> // If the original stack is in an unexpected format, our formatted stack<tr><td><a id="l557"></a><a href="#l557">557</a><td> // trace will be a bunch of &quot; at &lt;anonymous&gt;&quot; lines. If this is the case,<tr><td><a id="l558"></a><a href="#l558">558</a><td> // just return the error unmodified to avoid losing information. This is<tr><td><a id="l559"></a><a href="#l559">559</a><td> // necessary since the user may have defined a custom stack formatter in<tr><td><a id="l560"></a><a href="#l560">560</a><td> // V8 via Error.prepareStackTrace. See issue 7994.<tr><td><a id="l561"></a><a href="#l561">561</a><td> var isAnonymousFrame = function(frame) {<tr><td><a id="l562"></a><a href="#l562">562</a><td> return frame.toString() === &#39; at &lt;anonymous&gt;&#39;;<tr><td><a id="l563"></a><a href="#l563">563</a><td> };<tr><td><a id="l564"></a><a href="#l564">564</a><td> if (frames.length &amp;&amp; goog.array.every(frames, isAnonymousFrame)) {<tr><td><a id="l565"></a><a href="#l565">565</a><td> return error;<tr><td><a id="l566"></a><a href="#l566">566</a><td> }<tr><td><a id="l567"></a><a href="#l567">567</a><td><tr><td><a id="l568"></a><a href="#l568">568</a><td> // Older versions of IE simply return [object Error] for toString(), so<tr><td><a id="l569"></a><a href="#l569">569</a><td> // only use that as a last resort.<tr><td><a id="l570"></a><a href="#l570">570</a><td> var errorStr = &#39;&#39;;<tr><td><a id="l571"></a><a href="#l571">571</a><td> if (error.message) {<tr><td><a id="l572"></a><a href="#l572">572</a><td> errorStr = (error.name ? error.name + &#39;: &#39; : &#39;&#39;) + error.message;<tr><td><a id="l573"></a><a href="#l573">573</a><td> } else {<tr><td><a id="l574"></a><a href="#l574">574</a><td> errorStr = error.toString();<tr><td><a id="l575"></a><a href="#l575">575</a><td> }<tr><td><a id="l576"></a><a href="#l576">576</a><td><tr><td><a id="l577"></a><a href="#l577">577</a><td> // Ensure the error is in the V8 style with the error&#39;s string representation<tr><td><a id="l578"></a><a href="#l578">578</a><td> // prepended to the stack.<tr><td><a id="l579"></a><a href="#l579">579</a><td> error.stack = errorStr + &#39;\n&#39; + frames.join(&#39;\n&#39;);<tr><td><a id="l580"></a><a href="#l580">580</a><td> return error;<tr><td><a id="l581"></a><a href="#l581">581</a><td>};<tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td>/**<tr><td><a id="l585"></a><a href="#l585">585</a><td> * Parses an Error object&#39;s stack trace.<tr><td><a id="l586"></a><a href="#l586">586</a><td> * @param {string} stack The stack trace.<tr><td><a id="l587"></a><a href="#l587">587</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} Stack frames. The<tr><td><a id="l588"></a><a href="#l588">588</a><td> * unrecognized frames will be nulled out.<tr><td><a id="l589"></a><a href="#l589">589</a><td> * @private<tr><td><a id="l590"></a><a href="#l590">590</a><td> */<tr><td><a id="l591"></a><a href="#l591">591</a><td>webdriver.stacktrace.parse_ = function(stack) {<tr><td><a id="l592"></a><a href="#l592">592</a><td> if (!stack) {<tr><td><a id="l593"></a><a href="#l593">593</a><td> return [];<tr><td><a id="l594"></a><a href="#l594">594</a><td> }<tr><td><a id="l595"></a><a href="#l595">595</a><td><tr><td><a id="l596"></a><a href="#l596">596</a><td> var lines = stack.<tr><td><a id="l597"></a><a href="#l597">597</a><td> replace(/\s*$/, &#39;&#39;).<tr><td><a id="l598"></a><a href="#l598">598</a><td> split(&#39;\n&#39;);<tr><td><a id="l599"></a><a href="#l599">599</a><td> var frames = [];<tr><td><a id="l600"></a><a href="#l600">600</a><td> for (var i = 0; i &lt; lines.length; i++) {<tr><td><a id="l601"></a><a href="#l601">601</a><td> var frame = webdriver.stacktrace.parseStackFrame_(lines[i]);<tr><td><a id="l602"></a><a href="#l602">602</a><td> // The first two frames will be:<tr><td><a id="l603"></a><a href="#l603">603</a><td> // webdriver.stacktrace.Snapshot()<tr><td><a id="l604"></a><a href="#l604">604</a><td> // webdriver.stacktrace.get()<tr><td><a id="l605"></a><a href="#l605">605</a><td> frames.push(frame || webdriver.stacktrace.ANONYMOUS_FRAME_);<tr><td><a id="l606"></a><a href="#l606">606</a><td> }<tr><td><a id="l607"></a><a href="#l607">607</a><td> return frames;<tr><td><a id="l608"></a><a href="#l608">608</a><td>};<tr><td><a id="l609"></a><a href="#l609">609</a><td><tr><td><a id="l610"></a><a href="#l610">610</a><td><tr><td><a id="l611"></a><a href="#l611">611</a><td>/**<tr><td><a id="l612"></a><a href="#l612">612</a><td> * Gets the native stack trace if available otherwise follows the call chain.<tr><td><a id="l613"></a><a href="#l613">613</a><td> * The generated trace will exclude all frames up to and including the call to<tr><td><a id="l614"></a><a href="#l614">614</a><td> * this function.<tr><td><a id="l615"></a><a href="#l615">615</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The frames of the stack trace.<tr><td><a id="l616"></a><a href="#l616">616</a><td> */<tr><td><a id="l617"></a><a href="#l617">617</a><td>webdriver.stacktrace.get = function() {<tr><td><a id="l618"></a><a href="#l618">618</a><td> return new webdriver.stacktrace.Snapshot(1).getStacktrace();<tr><td><a id="l619"></a><a href="#l619">619</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/testing/asserts.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>asserts.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/testing/asserts.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 Assertions and expectation utilities for use in WebDriver test<tr><td><a id="l20"></a><a href="#l20">20</a><td> * cases.<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.testing.Assertion&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.testing.ContainsMatcher&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.testing.NegatedAssertion&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;webdriver.testing.assert&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;webdriver.testing.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td><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;goog.labs.testing.CloseToMatcher&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.labs.testing.EndsWithMatcher&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.labs.testing.EqualToMatcher&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.labs.testing.EqualsMatcher&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.labs.testing.GreaterThanEqualToMatcher&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.labs.testing.GreaterThanMatcher&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.labs.testing.LessThanEqualToMatcher&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.labs.testing.LessThanMatcher&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.labs.testing.InstanceOfMatcher&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.labs.testing.IsNotMatcher&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.labs.testing.IsNullMatcher&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.labs.testing.IsNullOrUndefinedMatcher&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.labs.testing.IsUndefinedMatcher&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.labs.testing.ObjectEqualsMatcher&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.labs.testing.RegexMatcher&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.labs.testing.StartsWithMatcher&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.labs.testing.assertThat&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.require(&#39;webdriver.promise&#39;);<tr><td><a id="l50"></a><a href="#l50">50</a><td><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> * Accepts strins or array-like structures that contain {@code value}.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {*} value The value to check for.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @constructor<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>webdriver.testing.ContainsMatcher = function(value) {<tr><td><a id="l59"></a><a href="#l59">59</a><td> /** @private {*} */<tr><td><a id="l60"></a><a href="#l60">60</a><td> this.value_ = value;<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>/** @override */<tr><td><a id="l65"></a><a href="#l65">65</a><td>webdriver.testing.ContainsMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l66"></a><a href="#l66">66</a><td> if (goog.isString(actualValue)) {<tr><td><a id="l67"></a><a href="#l67">67</a><td> return goog.string.contains(<tr><td><a id="l68"></a><a href="#l68">68</a><td> actualValue, /** @type {string} */(this.value_));<tr><td><a id="l69"></a><a href="#l69">69</a><td> } else {<tr><td><a id="l70"></a><a href="#l70">70</a><td> return goog.array.contains(<tr><td><a id="l71"></a><a href="#l71">71</a><td> /** @type {goog.array.ArrayLike} */(actualValue), this.value_);<tr><td><a id="l72"></a><a href="#l72">72</a><td> }<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/** @override */<tr><td><a id="l77"></a><a href="#l77">77</a><td>webdriver.testing.ContainsMatcher.prototype.describe = function(actualValue) {<tr><td><a id="l78"></a><a href="#l78">78</a><td> return actualValue + &#39; does not contain &#39; + this.value_;<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Utility for performing assertions against a given {@code value}. If the<tr><td><a id="l85"></a><a href="#l85">85</a><td> * value is a {@link webdriver.promise.Promise}, this assertion will wait<tr><td><a id="l86"></a><a href="#l86">86</a><td> * for it to resolve before applying any matchers.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {*} value The value to wrap and apply matchers to.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @constructor<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>webdriver.testing.Assertion = function(value) {<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td> /** @private {*} */<tr><td><a id="l93"></a><a href="#l93">93</a><td> this.value_ = value;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td> if (!(this instanceof webdriver.testing.NegatedAssertion)) {<tr><td><a id="l96"></a><a href="#l96">96</a><td> /**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * A self reference provided for writing fluent assertions:<tr><td><a id="l98"></a><a href="#l98">98</a><td> * webdriver.testing.assert(x).is.equalTo(y);<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @type {!webdriver.testing.Assertion}<tr><td><a id="l100"></a><a href="#l100">100</a><td> */<tr><td><a id="l101"></a><a href="#l101">101</a><td> this.is = this;<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td> /**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Negates any matchers applied to this instance&#39;s value:<tr><td><a id="l105"></a><a href="#l105">105</a><td> * webdriver.testing.assert(x).not.equalTo(y);<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @type {!webdriver.testing.NegatedAssertion}<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td> this.not = new webdriver.testing.NegatedAssertion(value);<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>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Wraps an object literal implementing the Matcher interface. This is used<tr><td><a id="l115"></a><a href="#l115">115</a><td> * to appease the Closure compiler, which will not treat an object literal as<tr><td><a id="l116"></a><a href="#l116">116</a><td> * implementing an interface.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @param {{matches: function(*): boolean, describe: function(): string}} obj<tr><td><a id="l118"></a><a href="#l118">118</a><td> * The object literal to delegate to.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @constructor<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @private<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.testing.Assertion.DelegatingMatcher_ = function(obj) {<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td> /** @override */<tr><td><a id="l126"></a><a href="#l126">126</a><td> this.matches = function(value) {<tr><td><a id="l127"></a><a href="#l127">127</a><td> return obj.matches(value);<tr><td><a id="l128"></a><a href="#l128">128</a><td> };<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td> /** @override */<tr><td><a id="l131"></a><a href="#l131">131</a><td> this.describe = function() {<tr><td><a id="l132"></a><a href="#l132">132</a><td> return obj.describe();<tr><td><a id="l133"></a><a href="#l133">133</a><td> };<tr><td><a id="l134"></a><a href="#l134">134</a><td>};<tr><td><a id="l135"></a><a href="#l135">135</a><td><tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Asserts that the given {@code matcher} accepts the value wrapped by this<tr><td><a id="l139"></a><a href="#l139">139</a><td> * instance. If the wrapped value is a promise, this function will defer<tr><td><a id="l140"></a><a href="#l140">140</a><td> * applying the assertion until the value has been resolved. Otherwise, it<tr><td><a id="l141"></a><a href="#l141">141</a><td> * will be applied immediately.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to apply<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l144"></a><a href="#l144">144</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {webdriver.promise.Promise} The deferred assertion result, or<tr><td><a id="l146"></a><a href="#l146">146</a><td> * {@code null} if the assertion was immediately applied.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @protected<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>webdriver.testing.Assertion.prototype.apply = function(matcher, opt_message) {<tr><td><a id="l150"></a><a href="#l150">150</a><td> var result = null;<tr><td><a id="l151"></a><a href="#l151">151</a><td> if (webdriver.promise.isPromise(this.value_)) {<tr><td><a id="l152"></a><a href="#l152">152</a><td> result = webdriver.promise.when(this.value_, function(value) {<tr><td><a id="l153"></a><a href="#l153">153</a><td> goog.labs.testing.assertThat(value, matcher, opt_message);<tr><td><a id="l154"></a><a href="#l154">154</a><td> });<tr><td><a id="l155"></a><a href="#l155">155</a><td> } else {<tr><td><a id="l156"></a><a href="#l156">156</a><td> goog.labs.testing.assertThat(this.value_, matcher, opt_message);<tr><td><a id="l157"></a><a href="#l157">157</a><td> }<tr><td><a id="l158"></a><a href="#l158">158</a><td> return result;<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> * Asserts that the value managed by this assertion is a number strictly<tr><td><a id="l164"></a><a href="#l164">164</a><td> * greater than {@code value}.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {number} value The minimum value.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l167"></a><a href="#l167">167</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>webdriver.testing.Assertion.prototype.greaterThan = function(<tr><td><a id="l171"></a><a href="#l171">171</a><td> value, opt_message) {<tr><td><a id="l172"></a><a href="#l172">172</a><td> return this.apply(<tr><td><a id="l173"></a><a href="#l173">173</a><td> new goog.labs.testing.GreaterThanMatcher(value), opt_message);<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * Asserts that the value managed by this assertion is a number &gt;= the given<tr><td><a id="l179"></a><a href="#l179">179</a><td> * value.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {number} value The minimum value.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l182"></a><a href="#l182">182</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>webdriver.testing.Assertion.prototype.greaterThanEqualTo = function(<tr><td><a id="l186"></a><a href="#l186">186</a><td> value, opt_message) {<tr><td><a id="l187"></a><a href="#l187">187</a><td> return this.apply(<tr><td><a id="l188"></a><a href="#l188">188</a><td> new goog.labs.testing.GreaterThanEqualToMatcher(value), opt_message);<tr><td><a id="l189"></a><a href="#l189">189</a><td>};<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Asserts that the value managed by this assertion is a number strictly less<tr><td><a id="l194"></a><a href="#l194">194</a><td> * than the given value.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {number} value The maximum value.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l197"></a><a href="#l197">197</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>webdriver.testing.Assertion.prototype.lessThan = function(value, opt_message) {<tr><td><a id="l201"></a><a href="#l201">201</a><td> return this.apply(<tr><td><a id="l202"></a><a href="#l202">202</a><td> new goog.labs.testing.LessThanMatcher(value), opt_message);<tr><td><a id="l203"></a><a href="#l203">203</a><td>};<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Asserts that the value managed by this assertion is a number &lt;= the given<tr><td><a id="l208"></a><a href="#l208">208</a><td> * value.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @param {number} value The maximum value.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l211"></a><a href="#l211">211</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l213"></a><a href="#l213">213</a><td> */<tr><td><a id="l214"></a><a href="#l214">214</a><td>webdriver.testing.Assertion.prototype.lessThanEqualTo = function(<tr><td><a id="l215"></a><a href="#l215">215</a><td> value, opt_message) {<tr><td><a id="l216"></a><a href="#l216">216</a><td> return this.apply(<tr><td><a id="l217"></a><a href="#l217">217</a><td> new goog.labs.testing.LessThanEqualToMatcher(value), opt_message);<tr><td><a id="l218"></a><a href="#l218">218</a><td>};<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Asserts that the wrapped value is a number within a given distance of an<tr><td><a id="l223"></a><a href="#l223">223</a><td> * expected value.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {number} value The expected value.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @param {number} range The maximum amount the actual value is permitted to<tr><td><a id="l226"></a><a href="#l226">226</a><td> * differ from the expected value.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l228"></a><a href="#l228">228</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l230"></a><a href="#l230">230</a><td> */<tr><td><a id="l231"></a><a href="#l231">231</a><td>webdriver.testing.Assertion.prototype.closeTo = function(<tr><td><a id="l232"></a><a href="#l232">232</a><td> value, range, opt_message) {<tr><td><a id="l233"></a><a href="#l233">233</a><td> return this.apply(<tr><td><a id="l234"></a><a href="#l234">234</a><td> new goog.labs.testing.CloseToMatcher(value, range), opt_message);<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>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Asserts that the wrapped value is an instance of the given class.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!Function} ctor The expected class constructor.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l242"></a><a href="#l242">242</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l244"></a><a href="#l244">244</a><td> */<tr><td><a id="l245"></a><a href="#l245">245</a><td>webdriver.testing.Assertion.prototype.instanceOf = function(ctor, opt_message) {<tr><td><a id="l246"></a><a href="#l246">246</a><td> return this.apply(<tr><td><a id="l247"></a><a href="#l247">247</a><td> new goog.labs.testing.InstanceOfMatcher(ctor), opt_message);<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> * Asserts that the wrapped value is null.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l254"></a><a href="#l254">254</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l256"></a><a href="#l256">256</a><td> */<tr><td><a id="l257"></a><a href="#l257">257</a><td>webdriver.testing.Assertion.prototype.isNull = function(opt_message) {<tr><td><a id="l258"></a><a href="#l258">258</a><td> return this.apply(new goog.labs.testing.IsNullMatcher(), opt_message);<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Asserts that the wrapped value is undefined.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l265"></a><a href="#l265">265</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>webdriver.testing.Assertion.prototype.isUndefined = function(opt_message) {<tr><td><a id="l269"></a><a href="#l269">269</a><td> return this.apply(new goog.labs.testing.IsUndefinedMatcher(), opt_message);<tr><td><a id="l270"></a><a href="#l270">270</a><td>};<tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td>/**<tr><td><a id="l274"></a><a href="#l274">274</a><td> * Asserts that the wrapped value is null or undefined.<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l276"></a><a href="#l276">276</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>webdriver.testing.Assertion.prototype.isNullOrUndefined = function(<tr><td><a id="l280"></a><a href="#l280">280</a><td> opt_message) {<tr><td><a id="l281"></a><a href="#l281">281</a><td> return this.apply(<tr><td><a id="l282"></a><a href="#l282">282</a><td> new goog.labs.testing.IsNullOrUndefinedMatcher(), opt_message);<tr><td><a id="l283"></a><a href="#l283">283</a><td>};<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>/**<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Asserts that the wrapped value is a string or array-like structure<tr><td><a id="l288"></a><a href="#l288">288</a><td> * containing the given value.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @param {*} value The expected value.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l291"></a><a href="#l291">291</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>webdriver.testing.Assertion.prototype.contains = function(value, opt_message) {<tr><td><a id="l295"></a><a href="#l295">295</a><td> return this.apply(<tr><td><a id="l296"></a><a href="#l296">296</a><td> new webdriver.testing.ContainsMatcher(value), opt_message);<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Asserts that the wrapped value is a string ending with the given suffix.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @param {string} suffix The expected suffix.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l304"></a><a href="#l304">304</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>webdriver.testing.Assertion.prototype.endsWith = function(<tr><td><a id="l308"></a><a href="#l308">308</a><td> suffix, opt_message) {<tr><td><a id="l309"></a><a href="#l309">309</a><td> return this.apply(<tr><td><a id="l310"></a><a href="#l310">310</a><td> new goog.labs.testing.EndsWithMatcher(suffix), opt_message);<tr><td><a id="l311"></a><a href="#l311">311</a><td>};<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td>/**<tr><td><a id="l315"></a><a href="#l315">315</a><td> * Asserts that the wrapped value is a string starting with the given prefix.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {string} prefix The expected prefix.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l318"></a><a href="#l318">318</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>webdriver.testing.Assertion.prototype.startsWith = function(<tr><td><a id="l322"></a><a href="#l322">322</a><td> prefix, opt_message) {<tr><td><a id="l323"></a><a href="#l323">323</a><td> return this.apply(<tr><td><a id="l324"></a><a href="#l324">324</a><td> new goog.labs.testing.StartsWithMatcher(prefix), opt_message);<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Asserts that the wrapped value is a string that matches the given RegExp.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {!RegExp} regex The regex to test.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l332"></a><a href="#l332">332</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>webdriver.testing.Assertion.prototype.matches = function(regex, opt_message) {<tr><td><a id="l336"></a><a href="#l336">336</a><td> return this.apply(new goog.labs.testing.RegexMatcher(regex), opt_message);<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Asserts that the value managed by this assertion is strictly equal to the<tr><td><a id="l342"></a><a href="#l342">342</a><td> * given {@code value}.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @param {*} value The expected value.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l345"></a><a href="#l345">345</a><td> * accept the value wrapped by this assertion.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>webdriver.testing.Assertion.prototype.equalTo = function(value, opt_message) {<tr><td><a id="l349"></a><a href="#l349">349</a><td> return this.apply(webdriver.testing.asserts.equalTo(value), opt_message);<tr><td><a id="l350"></a><a href="#l350">350</a><td>};<tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>/**<tr><td><a id="l354"></a><a href="#l354">354</a><td> * Asserts that the value managed by this assertion is strictly true.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l356"></a><a href="#l356">356</a><td> */<tr><td><a id="l357"></a><a href="#l357">357</a><td>webdriver.testing.Assertion.prototype.isTrue = function() {<tr><td><a id="l358"></a><a href="#l358">358</a><td> return this.equalTo(true);<tr><td><a id="l359"></a><a href="#l359">359</a><td>};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td>/**<tr><td><a id="l363"></a><a href="#l363">363</a><td> * Asserts that the value managed by this assertion is strictly false.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>webdriver.testing.Assertion.prototype.isFalse = function() {<tr><td><a id="l367"></a><a href="#l367">367</a><td> return this.equalTo(false);<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><tr><td><a id="l372"></a><a href="#l372">372</a><td>/**<tr><td><a id="l373"></a><a href="#l373">373</a><td> * An assertion that negates any applied matchers.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {*} value The value to perform assertions on.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @constructor<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @extends {webdriver.testing.Assertion}<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>webdriver.testing.NegatedAssertion = function(value) {<tr><td><a id="l379"></a><a href="#l379">379</a><td> webdriver.testing.NegatedAssertion.base(this, &#39;constructor&#39;, value);<tr><td><a id="l380"></a><a href="#l380">380</a><td> this.value = value;<tr><td><a id="l381"></a><a href="#l381">381</a><td>};<tr><td><a id="l382"></a><a href="#l382">382</a><td>goog.inherits(<tr><td><a id="l383"></a><a href="#l383">383</a><td> webdriver.testing.NegatedAssertion, webdriver.testing.Assertion);<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/** @override */<tr><td><a id="l387"></a><a href="#l387">387</a><td>webdriver.testing.NegatedAssertion.prototype.apply = function(<tr><td><a id="l388"></a><a href="#l388">388</a><td> matcher, opt_message) {<tr><td><a id="l389"></a><a href="#l389">389</a><td> matcher = new goog.labs.testing.IsNotMatcher(matcher);<tr><td><a id="l390"></a><a href="#l390">390</a><td> return webdriver.testing.NegatedAssertion.base(this, &#39;apply&#39;, matcher,<tr><td><a id="l391"></a><a href="#l391">391</a><td> opt_message);<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> * Creates a new assertion.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {*} value The value to perform an assertion on.<tr><td><a id="l397"></a><a href="#l397">397</a><td> * @return {!webdriver.testing.Assertion} The new assertion.<tr><td><a id="l398"></a><a href="#l398">398</a><td> */<tr><td><a id="l399"></a><a href="#l399">399</a><td>webdriver.testing.assert = function(value) {<tr><td><a id="l400"></a><a href="#l400">400</a><td> return new webdriver.testing.Assertion(value);<tr><td><a id="l401"></a><a href="#l401">401</a><td>};<tr><td><a id="l402"></a><a href="#l402">402</a><td><tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td>/**<tr><td><a id="l405"></a><a href="#l405">405</a><td> * Registers a new assertion to expose from the<tr><td><a id="l406"></a><a href="#l406">406</a><td> * {@link webdriver.testing.Assertion} prototype.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @param {string} name The assertion name.<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @param {(function(new: goog.labs.testing.Matcher, *)|<tr><td><a id="l409"></a><a href="#l409">409</a><td> * {matches: function(*): boolean,<tr><td><a id="l410"></a><a href="#l410">410</a><td> * describe: function(): string})} matcherTemplate Either the<tr><td><a id="l411"></a><a href="#l411">411</a><td> * matcher constructor to use, or an object literal defining a matcher.<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>webdriver.testing.assert.register = function(name, matcherTemplate) {<tr><td><a id="l414"></a><a href="#l414">414</a><td> webdriver.testing.Assertion.prototype[name] = function(value, opt_message) {<tr><td><a id="l415"></a><a href="#l415">415</a><td> var matcher;<tr><td><a id="l416"></a><a href="#l416">416</a><td> if (goog.isFunction(matcherTemplate)) {<tr><td><a id="l417"></a><a href="#l417">417</a><td> var ctor = /** @type {function(new: goog.labs.testing.Matcher, *)} */ (<tr><td><a id="l418"></a><a href="#l418">418</a><td> matcherTemplate);<tr><td><a id="l419"></a><a href="#l419">419</a><td> matcher = new ctor(value);<tr><td><a id="l420"></a><a href="#l420">420</a><td> } else {<tr><td><a id="l421"></a><a href="#l421">421</a><td> matcher = new webdriver.testing.Assertion.DelegatingMatcher_(value);<tr><td><a id="l422"></a><a href="#l422">422</a><td> }<tr><td><a id="l423"></a><a href="#l423">423</a><td> return this.apply(matcher, opt_message);<tr><td><a id="l424"></a><a href="#l424">424</a><td> };<tr><td><a id="l425"></a><a href="#l425">425</a><td>};<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>/**<tr><td><a id="l429"></a><a href="#l429">429</a><td> * Asserts that a matcher accepts a given value. This function has two<tr><td><a id="l430"></a><a href="#l430">430</a><td> * signatures based on the number of arguments:<tr><td><a id="l431"></a><a href="#l431">431</a><td> *<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Two arguments:<tr><td><a id="l433"></a><a href="#l433">433</a><td> * assertThat(actualValue, matcher)<tr><td><a id="l434"></a><a href="#l434">434</a><td> * Three arguments:<tr><td><a id="l435"></a><a href="#l435">435</a><td> * assertThat(failureMessage, actualValue, matcher)<tr><td><a id="l436"></a><a href="#l436">436</a><td> *<tr><td><a id="l437"></a><a href="#l437">437</a><td> * @param {*} failureMessageOrActualValue Either a failure message or the value<tr><td><a id="l438"></a><a href="#l438">438</a><td> * to apply to the given matcher.<tr><td><a id="l439"></a><a href="#l439">439</a><td> * @param {*} actualValueOrMatcher Either the value to apply to the given<tr><td><a id="l440"></a><a href="#l440">440</a><td> * matcher, or the matcher itself.<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @param {goog.labs.testing.Matcher=} opt_matcher The matcher to use;<tr><td><a id="l442"></a><a href="#l442">442</a><td> * ignored unless this function is invoked with three arguments.<tr><td><a id="l443"></a><a href="#l443">443</a><td> * @return {!webdriver.promise.Promise} The assertion result.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @deprecated Use webdriver.testing.asserts.assert instead.<tr><td><a id="l445"></a><a href="#l445">445</a><td> */<tr><td><a id="l446"></a><a href="#l446">446</a><td>webdriver.testing.asserts.assertThat = function(<tr><td><a id="l447"></a><a href="#l447">447</a><td> failureMessageOrActualValue, actualValueOrMatcher, opt_matcher) {<tr><td><a id="l448"></a><a href="#l448">448</a><td> var args = goog.array.slice(arguments, 0);<tr><td><a id="l449"></a><a href="#l449">449</a><td><tr><td><a id="l450"></a><a href="#l450">450</a><td> var message = args.length &gt; 2 ? args.shift() : &#39;&#39;;<tr><td><a id="l451"></a><a href="#l451">451</a><td> if (message) message += &#39;\n&#39;;<tr><td><a id="l452"></a><a href="#l452">452</a><td><tr><td><a id="l453"></a><a href="#l453">453</a><td> var actualValue = args.shift();<tr><td><a id="l454"></a><a href="#l454">454</a><td> var matcher = args.shift();<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td> return webdriver.promise.when(actualValue, function(value) {<tr><td><a id="l457"></a><a href="#l457">457</a><td> goog.labs.testing.assertThat(value, matcher, message);<tr><td><a id="l458"></a><a href="#l458">458</a><td> });<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><tr><td><a id="l462"></a><a href="#l462">462</a><td>/**<tr><td><a id="l463"></a><a href="#l463">463</a><td> * Creates an equality matcher.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @param {*} expected The expected value.<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @return {!goog.labs.testing.Matcher} The new matcher.<tr><td><a id="l466"></a><a href="#l466">466</a><td> */<tr><td><a id="l467"></a><a href="#l467">467</a><td>webdriver.testing.asserts.equalTo = function(expected) {<tr><td><a id="l468"></a><a href="#l468">468</a><td> if (goog.isString(expected)) {<tr><td><a id="l469"></a><a href="#l469">469</a><td> return new goog.labs.testing.EqualsMatcher(expected);<tr><td><a id="l470"></a><a href="#l470">470</a><td> } else if (goog.isNumber(expected)) {<tr><td><a id="l471"></a><a href="#l471">471</a><td> return new goog.labs.testing.EqualToMatcher(expected);<tr><td><a id="l472"></a><a href="#l472">472</a><td> } else {<tr><td><a id="l473"></a><a href="#l473">473</a><td> return new goog.labs.testing.ObjectEqualsMatcher(<tr><td><a id="l474"></a><a href="#l474">474</a><td> /** @type {!Object} */ (expected));<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><tr><td><a id="l479"></a><a href="#l479">479</a><td>goog.exportSymbol(&#39;assertThat&#39;, webdriver.testing.asserts.assertThat);<tr><td><a id="l480"></a><a href="#l480">480</a><td>// Mappings for goog.labs.testing matcher functions to the legacy<tr><td><a id="l481"></a><a href="#l481">481</a><td>// webdriver.testing.asserts matchers.<tr><td><a id="l482"></a><a href="#l482">482</a><td>goog.exportSymbol(&#39;contains&#39;, containsString);<tr><td><a id="l483"></a><a href="#l483">483</a><td>goog.exportSymbol(&#39;equalTo&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.exportSymbol(&#39;equals&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l485"></a><a href="#l485">485</a><td>goog.exportSymbol(&#39;is&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l486"></a><a href="#l486">486</a><td>goog.exportSymbol(&#39;not&#39;, isNot);<tr><td><a id="l487"></a><a href="#l487">487</a><td>goog.exportSymbol(&#39;or&#39;, anyOf);</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/touchsequence.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>touchsequence.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/touchsequence.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.TouchSequence&#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>goog.require(&#39;goog.array&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;webdriver.CommandName&#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> * Class for defining sequences of user touch interactions. Each sequence<tr><td><a id="l28"></a><a href="#l28">28</a><td> * will not be executed until {@link #perform} is called.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Example:<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * new webdriver.TouchSequence(driver).<tr><td><a id="l33"></a><a href="#l33">33</a><td> * tapAndHold({x: 0, y: 0}).<tr><td><a id="l34"></a><a href="#l34">34</a><td> * move({x: 3, y: 4}).<tr><td><a id="l35"></a><a href="#l35">35</a><td> * release({x: 10, y: 10}).<tr><td><a id="l36"></a><a href="#l36">36</a><td> * perform();<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @constructor<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.TouchSequence = function(driver) {<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td> /** @private {!webdriver.WebDriver} */<tr><td><a id="l44"></a><a href="#l44">44</a><td> this.driver_ = driver;<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td> /** @private {!Array&lt;{description: string, command: !webdriver.Command}&gt;} */<tr><td><a id="l47"></a><a href="#l47">47</a><td> this.touchActions_ = [];<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><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Schedules an action to be executed each time {@link #perform} is called on<tr><td><a id="l53"></a><a href="#l53">53</a><td> * this instance.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {string} description A description of the command.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!webdriver.Command} command The command.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @private<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>webdriver.TouchSequence.prototype.schedule_ = function(description, command) {<tr><td><a id="l59"></a><a href="#l59">59</a><td> this.touchActions_.push({<tr><td><a id="l60"></a><a href="#l60">60</a><td> description: description,<tr><td><a id="l61"></a><a href="#l61">61</a><td> command: command<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> * Executes this action sequence.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved once<tr><td><a id="l69"></a><a href="#l69">69</a><td> * this sequence has completed.<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.TouchSequence.prototype.perform = function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td> // Make a protected copy of the scheduled actions. This will protect against<tr><td><a id="l73"></a><a href="#l73">73</a><td> // users defining additional commands before this sequence is actually<tr><td><a id="l74"></a><a href="#l74">74</a><td> // executed.<tr><td><a id="l75"></a><a href="#l75">75</a><td> var actions = goog.array.clone(this.touchActions_);<tr><td><a id="l76"></a><a href="#l76">76</a><td> var driver = this.driver_;<tr><td><a id="l77"></a><a href="#l77">77</a><td> return driver.controlFlow().execute(function() {<tr><td><a id="l78"></a><a href="#l78">78</a><td> goog.array.forEach(actions, function(action) {<tr><td><a id="l79"></a><a href="#l79">79</a><td> driver.schedule(action.command, action.description);<tr><td><a id="l80"></a><a href="#l80">80</a><td> });<tr><td><a id="l81"></a><a href="#l81">81</a><td> }, &#39;TouchSequence.perform&#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><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Taps an element.<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {!webdriver.WebElement} elem The element to tap.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>webdriver.TouchSequence.prototype.tap = function(elem) {<tr><td><a id="l92"></a><a href="#l92">92</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_SINGLE_TAP).<tr><td><a id="l93"></a><a href="#l93">93</a><td> setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td> this.schedule_(&#39;tap&#39;, command);<tr><td><a id="l96"></a><a href="#l96">96</a><td> return this;<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><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Double taps an element.<tr><td><a id="l102"></a><a href="#l102">102</a><td> *<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {!webdriver.WebElement} elem The element to double tap.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>webdriver.TouchSequence.prototype.doubleTap = function(elem) {<tr><td><a id="l107"></a><a href="#l107">107</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOUBLE_TAP).<tr><td><a id="l108"></a><a href="#l108">108</a><td> setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td> this.schedule_(&#39;doubleTap&#39;, command);<tr><td><a id="l111"></a><a href="#l111">111</a><td> return this;<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><tr><td><a id="l115"></a><a href="#l115">115</a><td>/**<tr><td><a id="l116"></a><a href="#l116">116</a><td> * Long press on an element.<tr><td><a id="l117"></a><a href="#l117">117</a><td> *<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @param {!webdriver.WebElement} elem The element to long press.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td>webdriver.TouchSequence.prototype.longPress = function(elem) {<tr><td><a id="l122"></a><a href="#l122">122</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_LONG_PRESS).<tr><td><a id="l123"></a><a href="#l123">123</a><td> setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td> this.schedule_(&#39;longPress&#39;, command);<tr><td><a id="l126"></a><a href="#l126">126</a><td> return this;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>/**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * Touch down at the given location.<tr><td><a id="l132"></a><a href="#l132">132</a><td> *<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @param {{x: number, y: number}} location The location to touch down at.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>webdriver.TouchSequence.prototype.tapAndHold = function(location) {<tr><td><a id="l137"></a><a href="#l137">137</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOWN).<tr><td><a id="l138"></a><a href="#l138">138</a><td> setParameter(&#39;x&#39;, location.x).<tr><td><a id="l139"></a><a href="#l139">139</a><td> setParameter(&#39;y&#39;, location.y);<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td> this.schedule_(&#39;tapAndHold&#39;, command);<tr><td><a id="l142"></a><a href="#l142">142</a><td> return this;<tr><td><a id="l143"></a><a href="#l143">143</a><td>};<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>/**<tr><td><a id="l147"></a><a href="#l147">147</a><td> * Move a held {@linkplain #tapAndHold touch} to the specified location.<tr><td><a id="l148"></a><a href="#l148">148</a><td> *<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {{x: number, y: number}} location The location to move to.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>webdriver.TouchSequence.prototype.move = function(location) {<tr><td><a id="l153"></a><a href="#l153">153</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_MOVE).<tr><td><a id="l154"></a><a href="#l154">154</a><td> setParameter(&#39;x&#39;, location.x).<tr><td><a id="l155"></a><a href="#l155">155</a><td> setParameter(&#39;y&#39;, location.y);<tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td> this.schedule_(&#39;move&#39;, command);<tr><td><a id="l158"></a><a href="#l158">158</a><td> return this;<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> * Release a held {@linkplain #tapAndHold touch} at the specified location.<tr><td><a id="l164"></a><a href="#l164">164</a><td> *<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {{x: number, y: number}} location The location to release at.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>webdriver.TouchSequence.prototype.release = function(location) {<tr><td><a id="l169"></a><a href="#l169">169</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_UP).<tr><td><a id="l170"></a><a href="#l170">170</a><td> setParameter(&#39;x&#39;, location.x).<tr><td><a id="l171"></a><a href="#l171">171</a><td> setParameter(&#39;y&#39;, location.y);<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td> this.schedule_(&#39;release&#39;, command);<tr><td><a id="l174"></a><a href="#l174">174</a><td> return this;<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>/**<tr><td><a id="l179"></a><a href="#l179">179</a><td> * Scrolls the touch screen by the given offset.<tr><td><a id="l180"></a><a href="#l180">180</a><td> *<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {{x: number, y: number}} offset The offset to scroll to.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>webdriver.TouchSequence.prototype.scroll = function(offset) {<tr><td><a id="l185"></a><a href="#l185">185</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).<tr><td><a id="l186"></a><a href="#l186">186</a><td> setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l187"></a><a href="#l187">187</a><td> setParameter(&#39;yoffset&#39;, offset.y);<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td> this.schedule_(&#39;scroll&#39;, command);<tr><td><a id="l190"></a><a href="#l190">190</a><td> return this;<tr><td><a id="l191"></a><a href="#l191">191</a><td>};<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * Scrolls the touch screen, starting on `elem` and moving by the specified<tr><td><a id="l196"></a><a href="#l196">196</a><td> * offset.<tr><td><a id="l197"></a><a href="#l197">197</a><td> *<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @param {!webdriver.WebElement} elem The element where scroll starts.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {{x: number, y: number}} offset The offset to scroll to.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>webdriver.TouchSequence.prototype.scrollFromElement = function(elem, offset) {<tr><td><a id="l203"></a><a href="#l203">203</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).<tr><td><a id="l204"></a><a href="#l204">204</a><td> setParameter(&#39;element&#39;, elem.getRawId()).<tr><td><a id="l205"></a><a href="#l205">205</a><td> setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l206"></a><a href="#l206">206</a><td> setParameter(&#39;yoffset&#39;, offset.y);<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td> this.schedule_(&#39;scrollFromElement&#39;, command);<tr><td><a id="l209"></a><a href="#l209">209</a><td> return this;<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><tr><td><a id="l213"></a><a href="#l213">213</a><td>/**<tr><td><a id="l214"></a><a href="#l214">214</a><td> * Flick, starting anywhere on the screen, at speed xspeed and yspeed.<tr><td><a id="l215"></a><a href="#l215">215</a><td> *<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {{xspeed: number, yspeed: number}} speed The speed to flick in each<tr><td><a id="l217"></a><a href="#l217">217</a><td> direction, in pixels per second.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @return {!webdriver.TouchSequence} A self reference.<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.TouchSequence.prototype.flick = function(speed) {<tr><td><a id="l221"></a><a href="#l221">221</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).<tr><td><a id="l222"></a><a href="#l222">222</a><td> setParameter(&#39;xspeed&#39;, speed.xspeed).<tr><td><a id="l223"></a><a href="#l223">223</a><td> setParameter(&#39;yspeed&#39;, speed.yspeed);<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td> this.schedule_(&#39;flick&#39;, command);<tr><td><a id="l226"></a><a href="#l226">226</a><td> return this;<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> * Flick starting at elem and moving by x and y at specified speed.<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 {!webdriver.WebElement} elem The element where flick starts.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @param {{x: number, y: number}} offset The offset to flick to.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {number} speed The speed to flick at in pixels per second.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l237"></a><a href="#l237">237</a><td> */<tr><td><a id="l238"></a><a href="#l238">238</a><td>webdriver.TouchSequence.prototype.flickElement = function(elem, offset, speed) {<tr><td><a id="l239"></a><a href="#l239">239</a><td> var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).<tr><td><a id="l240"></a><a href="#l240">240</a><td> setParameter(&#39;element&#39;, elem.getRawId()).<tr><td><a id="l241"></a><a href="#l241">241</a><td> setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l242"></a><a href="#l242">242</a><td> setParameter(&#39;yoffset&#39;, offset.y).<tr><td><a id="l243"></a><a href="#l243">243</a><td> setParameter(&#39;speed&#39;, speed);<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td> this.schedule_(&#39;flickElement&#39;, command);<tr><td><a id="l246"></a><a href="#l246">246</a><td> return this;<tr><td><a id="l247"></a><a href="#l247">247</a><td>};<tr><td><a id="l248"></a><a href="#l248">248</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>