selenium-webdriver 2.47.0 → 2.52.0

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