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,727 +0,0 @@
1
- // Copyright 2008 The Closure Library Authors. All Rights Reserved.
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS-IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
-
15
- /**
16
- * @fileoverview Event Simulation.
17
- *
18
- * Utility functions for simulating events at the Closure level. All functions
19
- * in this package generate events by calling goog.events.fireListeners,
20
- * rather than interfacing with the browser directly. This is intended for
21
- * testing purposes, and should not be used in production code.
22
- *
23
- * The decision to use Closure events and dispatchers instead of the browser's
24
- * native events and dispatchers was conscious and deliberate. Native event
25
- * dispatchers have their own set of quirks and edge cases. Pure JS dispatchers
26
- * are more robust and transparent.
27
- *
28
- * If you think you need a testing mechanism that uses native Event objects,
29
- * please, please email closure-tech first to explain your use case before you
30
- * sink time into this.
31
- *
32
- * @author nicksantos@google.com (Nick Santos)
33
- */
34
-
35
- goog.provide('goog.testing.events');
36
- goog.provide('goog.testing.events.Event');
37
-
38
- goog.require('goog.Disposable');
39
- goog.require('goog.asserts');
40
- goog.require('goog.dom.NodeType');
41
- goog.require('goog.events');
42
- goog.require('goog.events.BrowserEvent');
43
- goog.require('goog.events.BrowserFeature');
44
- goog.require('goog.events.EventTarget');
45
- goog.require('goog.events.EventType');
46
- goog.require('goog.events.KeyCodes');
47
- goog.require('goog.object');
48
- goog.require('goog.style');
49
- goog.require('goog.userAgent');
50
-
51
-
52
-
53
- /**
54
- * goog.events.BrowserEvent expects an Event so we provide one for JSCompiler.
55
- *
56
- * This clones a lot of the functionality of goog.events.Event. This used to
57
- * use a mixin, but the mixin results in confusing the two types when compiled.
58
- *
59
- * @param {string} type Event Type.
60
- * @param {Object=} opt_target Reference to the object that is the target of
61
- * this event.
62
- * @constructor
63
- * @extends {Event}
64
- */
65
- goog.testing.events.Event = function(type, opt_target) {
66
- this.type = type;
67
-
68
- this.target = /** @type {EventTarget} */ (opt_target || null);
69
-
70
- this.currentTarget = this.target;
71
- };
72
-
73
-
74
- /**
75
- * Whether to cancel the event in internal capture/bubble processing for IE.
76
- * @type {boolean}
77
- * @public
78
- * @suppress {underscore|visibility} Technically public, but referencing this
79
- * outside this package is strongly discouraged.
80
- */
81
- goog.testing.events.Event.prototype.propagationStopped_ = false;
82
-
83
-
84
- /** @override */
85
- goog.testing.events.Event.prototype.defaultPrevented = false;
86
-
87
-
88
- /**
89
- * Return value for in internal capture/bubble processing for IE.
90
- * @type {boolean}
91
- * @public
92
- * @suppress {underscore|visibility} Technically public, but referencing this
93
- * outside this package is strongly discouraged.
94
- */
95
- goog.testing.events.Event.prototype.returnValue_ = true;
96
-
97
-
98
- /** @override */
99
- goog.testing.events.Event.prototype.stopPropagation = function() {
100
- this.propagationStopped_ = true;
101
- };
102
-
103
-
104
- /** @override */
105
- goog.testing.events.Event.prototype.preventDefault = function() {
106
- this.defaultPrevented = true;
107
- this.returnValue_ = false;
108
- };
109
-
110
-
111
- /**
112
- * Asserts an event target exists. This will fail if target is not defined.
113
- *
114
- * TODO(nnaze): Gradually add this to the methods in this file, and eventually
115
- * update the method signatures to not take nullables. See http://b/8961907
116
- *
117
- * @param {EventTarget} target A target to assert.
118
- * @return {!EventTarget} The target, guaranteed to exist.
119
- * @private
120
- */
121
- goog.testing.events.assertEventTarget_ = function(target) {
122
- return goog.asserts.assert(target, 'EventTarget should be defined.');
123
- };
124
-
125
-
126
- /**
127
- * A static helper function that sets the mouse position to the event.
128
- * @param {Event} event A simulated native event.
129
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
130
- * target's position (if available), otherwise (0, 0).
131
- * @private
132
- */
133
- goog.testing.events.setEventClientXY_ = function(event, opt_coords) {
134
- if (!opt_coords && event.target &&
135
- event.target.nodeType == goog.dom.NodeType.ELEMENT) {
136
- try {
137
- opt_coords =
138
- goog.style.getClientPosition(/** @type {!Element} **/ (event.target));
139
- } catch (ex) {
140
- // IE sometimes throws if it can't get the position.
141
- }
142
- }
143
- event.clientX = opt_coords ? opt_coords.x : 0;
144
- event.clientY = opt_coords ? opt_coords.y : 0;
145
-
146
- // Pretend the browser window is at (0, 0).
147
- event.screenX = event.clientX;
148
- event.screenY = event.clientY;
149
- };
150
-
151
-
152
- /**
153
- * Simulates a mousedown, mouseup, and then click on the given event target,
154
- * with the left mouse button.
155
- * @param {EventTarget} target The target for the event.
156
- * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
157
- * defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
158
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
159
- * target's position (if available), otherwise (0, 0).
160
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
161
- * BrowserEvent.
162
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
163
- * was called on any of the events, true otherwise.
164
- */
165
- goog.testing.events.fireClickSequence =
166
- function(target, opt_button, opt_coords, opt_eventProperties) {
167
- // Fire mousedown, mouseup, and click. Then return the bitwise AND of the 3.
168
- return !!(goog.testing.events.fireMouseDownEvent(
169
- target, opt_button, opt_coords, opt_eventProperties) &
170
- goog.testing.events.fireMouseUpEvent(
171
- target, opt_button, opt_coords, opt_eventProperties) &
172
- goog.testing.events.fireClickEvent(
173
- target, opt_button, opt_coords, opt_eventProperties));
174
- };
175
-
176
-
177
- /**
178
- * Simulates the sequence of events fired by the browser when the user double-
179
- * clicks the given target.
180
- * @param {EventTarget} target The target for the event.
181
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
182
- * target's position (if available), otherwise (0, 0).
183
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
184
- * BrowserEvent.
185
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
186
- * was called on any of the events, true otherwise.
187
- */
188
- goog.testing.events.fireDoubleClickSequence = function(
189
- target, opt_coords, opt_eventProperties) {
190
- // Fire mousedown, mouseup, click, mousedown, mouseup, click, dblclick.
191
- // Then return the bitwise AND of the 7.
192
- var btn = goog.events.BrowserEvent.MouseButton.LEFT;
193
- return !!(goog.testing.events.fireMouseDownEvent(
194
- target, btn, opt_coords, opt_eventProperties) &
195
- goog.testing.events.fireMouseUpEvent(
196
- target, btn, opt_coords, opt_eventProperties) &
197
- goog.testing.events.fireClickEvent(
198
- target, btn, opt_coords, opt_eventProperties) &
199
- // IE fires a selectstart instead of the second mousedown in a
200
- // dblclick, but we don't care about selectstart.
201
- (goog.userAgent.IE ||
202
- goog.testing.events.fireMouseDownEvent(
203
- target, btn, opt_coords, opt_eventProperties)) &
204
- goog.testing.events.fireMouseUpEvent(
205
- target, btn, opt_coords, opt_eventProperties) &
206
- // IE doesn't fire the second click in a dblclick.
207
- (goog.userAgent.IE ||
208
- goog.testing.events.fireClickEvent(
209
- target, btn, opt_coords, opt_eventProperties)) &
210
- goog.testing.events.fireDoubleClickEvent(
211
- target, opt_coords, opt_eventProperties));
212
- };
213
-
214
-
215
- /**
216
- * Simulates a complete keystroke (keydown, keypress, and keyup). Note that
217
- * if preventDefault is called on the keydown, the keypress will not fire.
218
- *
219
- * @param {EventTarget} target The target for the event.
220
- * @param {number} keyCode The keycode of the key pressed.
221
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
222
- * BrowserEvent.
223
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
224
- * was called on any of the events, true otherwise.
225
- */
226
- goog.testing.events.fireKeySequence = function(
227
- target, keyCode, opt_eventProperties) {
228
- return goog.testing.events.fireNonAsciiKeySequence(target, keyCode, keyCode,
229
- opt_eventProperties);
230
- };
231
-
232
-
233
- /**
234
- * Simulates a complete keystroke (keydown, keypress, and keyup) when typing
235
- * a non-ASCII character. Same as fireKeySequence, the keypress will not fire
236
- * if preventDefault is called on the keydown.
237
- *
238
- * @param {EventTarget} target The target for the event.
239
- * @param {number} keyCode The keycode of the keydown and keyup events.
240
- * @param {number} keyPressKeyCode The keycode of the keypress event.
241
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
242
- * BrowserEvent.
243
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
244
- * was called on any of the events, true otherwise.
245
- */
246
- goog.testing.events.fireNonAsciiKeySequence = function(
247
- target, keyCode, keyPressKeyCode, opt_eventProperties) {
248
- var keydown =
249
- new goog.testing.events.Event(goog.events.EventType.KEYDOWN, target);
250
- var keyup =
251
- new goog.testing.events.Event(goog.events.EventType.KEYUP, target);
252
- var keypress =
253
- new goog.testing.events.Event(goog.events.EventType.KEYPRESS, target);
254
- keydown.keyCode = keyup.keyCode = keyCode;
255
- keypress.keyCode = keyPressKeyCode;
256
-
257
- if (opt_eventProperties) {
258
- goog.object.extend(keydown, opt_eventProperties);
259
- goog.object.extend(keyup, opt_eventProperties);
260
- goog.object.extend(keypress, opt_eventProperties);
261
- }
262
-
263
- // Fire keydown, keypress, and keyup. Note that if the keydown is
264
- // prevent-defaulted, then the keypress will not fire.
265
- var result = true;
266
- if (!goog.testing.events.isBrokenGeckoMacActionKey_(keydown)) {
267
- result = goog.testing.events.fireBrowserEvent(keydown);
268
- }
269
- if (goog.events.KeyCodes.firesKeyPressEvent(
270
- keyCode, undefined, keydown.shiftKey, keydown.ctrlKey,
271
- keydown.altKey) && result) {
272
- result &= goog.testing.events.fireBrowserEvent(keypress);
273
- }
274
- return !!(result & goog.testing.events.fireBrowserEvent(keyup));
275
- };
276
-
277
-
278
- /**
279
- * @param {goog.testing.events.Event} e The event.
280
- * @return {boolean} Whether this is the Gecko/Mac's Meta-C/V/X, which
281
- * is broken and requires special handling.
282
- * @private
283
- */
284
- goog.testing.events.isBrokenGeckoMacActionKey_ = function(e) {
285
- return goog.userAgent.MAC && goog.userAgent.GECKO &&
286
- (e.keyCode == goog.events.KeyCodes.C ||
287
- e.keyCode == goog.events.KeyCodes.X ||
288
- e.keyCode == goog.events.KeyCodes.V) && e.metaKey;
289
- };
290
-
291
-
292
- /**
293
- * Simulates a mouseover event on the given target.
294
- * @param {EventTarget} target The target for the event.
295
- * @param {EventTarget} relatedTarget The related target for the event (e.g.,
296
- * the node that the mouse is being moved out of).
297
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
298
- * target's position (if available), otherwise (0, 0).
299
- * @return {boolean} The returnValue of the event: false if preventDefault() was
300
- * called on it, true otherwise.
301
- */
302
- goog.testing.events.fireMouseOverEvent = function(target, relatedTarget,
303
- opt_coords) {
304
- var mouseover =
305
- new goog.testing.events.Event(goog.events.EventType.MOUSEOVER, target);
306
- mouseover.relatedTarget = relatedTarget;
307
- goog.testing.events.setEventClientXY_(mouseover, opt_coords);
308
- return goog.testing.events.fireBrowserEvent(mouseover);
309
- };
310
-
311
-
312
- /**
313
- * Simulates a mousemove event on the given target.
314
- * @param {EventTarget} target The target for the event.
315
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
316
- * target's position (if available), otherwise (0, 0).
317
- * @return {boolean} The returnValue of the event: false if preventDefault() was
318
- * called on it, true otherwise.
319
- */
320
- goog.testing.events.fireMouseMoveEvent = function(target, opt_coords) {
321
- var mousemove =
322
- new goog.testing.events.Event(goog.events.EventType.MOUSEMOVE, target);
323
-
324
- goog.testing.events.setEventClientXY_(mousemove, opt_coords);
325
- return goog.testing.events.fireBrowserEvent(mousemove);
326
- };
327
-
328
-
329
- /**
330
- * Simulates a mouseout event on the given target.
331
- * @param {EventTarget} target The target for the event.
332
- * @param {EventTarget} relatedTarget The related target for the event (e.g.,
333
- * the node that the mouse is being moved into).
334
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
335
- * target's position (if available), otherwise (0, 0).
336
- * @return {boolean} The returnValue of the event: false if preventDefault() was
337
- * called on it, true otherwise.
338
- */
339
- goog.testing.events.fireMouseOutEvent = function(target, relatedTarget,
340
- opt_coords) {
341
- var mouseout =
342
- new goog.testing.events.Event(goog.events.EventType.MOUSEOUT, target);
343
- mouseout.relatedTarget = relatedTarget;
344
- goog.testing.events.setEventClientXY_(mouseout, opt_coords);
345
- return goog.testing.events.fireBrowserEvent(mouseout);
346
- };
347
-
348
-
349
- /**
350
- * Simulates a mousedown event on the given target.
351
- * @param {EventTarget} target The target for the event.
352
- * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
353
- * defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
354
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
355
- * target's position (if available), otherwise (0, 0).
356
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
357
- * BrowserEvent.
358
- * @return {boolean} The returnValue of the event: false if preventDefault() was
359
- * called on it, true otherwise.
360
- */
361
- goog.testing.events.fireMouseDownEvent =
362
- function(target, opt_button, opt_coords, opt_eventProperties) {
363
-
364
- var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
365
- button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
366
- goog.events.BrowserEvent.IEButtonMap[button] : button;
367
- return goog.testing.events.fireMouseButtonEvent_(
368
- goog.events.EventType.MOUSEDOWN, target, button, opt_coords,
369
- opt_eventProperties);
370
- };
371
-
372
-
373
- /**
374
- * Simulates a mouseup event on the given target.
375
- * @param {EventTarget} target The target for the event.
376
- * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
377
- * defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
378
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
379
- * target's position (if available), otherwise (0, 0).
380
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
381
- * BrowserEvent.
382
- * @return {boolean} The returnValue of the event: false if preventDefault() was
383
- * called on it, true otherwise.
384
- */
385
- goog.testing.events.fireMouseUpEvent =
386
- function(target, opt_button, opt_coords, opt_eventProperties) {
387
- var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
388
- button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
389
- goog.events.BrowserEvent.IEButtonMap[button] : button;
390
- return goog.testing.events.fireMouseButtonEvent_(
391
- goog.events.EventType.MOUSEUP, target, button, opt_coords,
392
- opt_eventProperties);
393
- };
394
-
395
-
396
- /**
397
- * Simulates a click event on the given target. IE only supports click with
398
- * the left mouse button.
399
- * @param {EventTarget} target The target for the event.
400
- * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
401
- * defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
402
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
403
- * target's position (if available), otherwise (0, 0).
404
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
405
- * BrowserEvent.
406
- * @return {boolean} The returnValue of the event: false if preventDefault() was
407
- * called on it, true otherwise.
408
- */
409
- goog.testing.events.fireClickEvent =
410
- function(target, opt_button, opt_coords, opt_eventProperties) {
411
- return goog.testing.events.fireMouseButtonEvent_(goog.events.EventType.CLICK,
412
- target, opt_button, opt_coords, opt_eventProperties);
413
- };
414
-
415
-
416
- /**
417
- * Simulates a double-click event on the given target. Always double-clicks
418
- * with the left mouse button since no browser supports double-clicking with
419
- * any other buttons.
420
- * @param {EventTarget} target The target for the event.
421
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
422
- * target's position (if available), otherwise (0, 0).
423
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
424
- * BrowserEvent.
425
- * @return {boolean} The returnValue of the event: false if preventDefault() was
426
- * called on it, true otherwise.
427
- */
428
- goog.testing.events.fireDoubleClickEvent =
429
- function(target, opt_coords, opt_eventProperties) {
430
- return goog.testing.events.fireMouseButtonEvent_(
431
- goog.events.EventType.DBLCLICK, target,
432
- goog.events.BrowserEvent.MouseButton.LEFT, opt_coords,
433
- opt_eventProperties);
434
- };
435
-
436
-
437
- /**
438
- * Helper function to fire a mouse event.
439
- * with the left mouse button since no browser supports double-clicking with
440
- * any other buttons.
441
- * @param {string} type The event type.
442
- * @param {EventTarget} target The target for the event.
443
- * @param {number=} opt_button Mouse button; defaults to
444
- * {@code goog.events.BrowserEvent.MouseButton.LEFT}.
445
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
446
- * target's position (if available), otherwise (0, 0).
447
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
448
- * BrowserEvent.
449
- * @return {boolean} The returnValue of the event: false if preventDefault() was
450
- * called on it, true otherwise.
451
- * @private
452
- */
453
- goog.testing.events.fireMouseButtonEvent_ =
454
- function(type, target, opt_button, opt_coords, opt_eventProperties) {
455
- var e =
456
- new goog.testing.events.Event(type, target);
457
- e.button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
458
- goog.testing.events.setEventClientXY_(e, opt_coords);
459
- if (opt_eventProperties) {
460
- goog.object.extend(e, opt_eventProperties);
461
- }
462
- return goog.testing.events.fireBrowserEvent(e);
463
- };
464
-
465
-
466
- /**
467
- * Simulates a contextmenu event on the given target.
468
- * @param {EventTarget} target The target for the event.
469
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
470
- * target's position (if available), otherwise (0, 0).
471
- * @return {boolean} The returnValue of the event: false if preventDefault() was
472
- * called on it, true otherwise.
473
- */
474
- goog.testing.events.fireContextMenuEvent = function(target, opt_coords) {
475
- var button = (goog.userAgent.MAC && goog.userAgent.WEBKIT) ?
476
- goog.events.BrowserEvent.MouseButton.LEFT :
477
- goog.events.BrowserEvent.MouseButton.RIGHT;
478
- var contextmenu =
479
- new goog.testing.events.Event(goog.events.EventType.CONTEXTMENU, target);
480
- contextmenu.button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
481
- goog.events.BrowserEvent.IEButtonMap[button] : button;
482
- contextmenu.ctrlKey = goog.userAgent.MAC;
483
- goog.testing.events.setEventClientXY_(contextmenu, opt_coords);
484
- return goog.testing.events.fireBrowserEvent(contextmenu);
485
- };
486
-
487
-
488
- /**
489
- * Simulates a mousedown, contextmenu, and the mouseup on the given event
490
- * target, with the right mouse button.
491
- * @param {EventTarget} target The target for the event.
492
- * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
493
- * target's position (if available), otherwise (0, 0).
494
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
495
- * was called on any of the events, true otherwise.
496
- */
497
- goog.testing.events.fireContextMenuSequence = function(target, opt_coords) {
498
- var props = goog.userAgent.MAC ? {ctrlKey: true} : {};
499
- var button = (goog.userAgent.MAC && goog.userAgent.WEBKIT) ?
500
- goog.events.BrowserEvent.MouseButton.LEFT :
501
- goog.events.BrowserEvent.MouseButton.RIGHT;
502
-
503
- var result = goog.testing.events.fireMouseDownEvent(target,
504
- button, opt_coords, props);
505
- if (goog.userAgent.WINDOWS) {
506
- // All browsers are consistent on Windows.
507
- result &= goog.testing.events.fireMouseUpEvent(target,
508
- button, opt_coords) &
509
- goog.testing.events.fireContextMenuEvent(target, opt_coords);
510
- } else {
511
- result &= goog.testing.events.fireContextMenuEvent(target, opt_coords);
512
-
513
- // GECKO on Mac and Linux always fires the mouseup after the contextmenu.
514
-
515
- // WEBKIT is really weird.
516
- //
517
- // On Linux, it sometimes fires mouseup, but most of the time doesn't.
518
- // It's really hard to reproduce consistently. I think there's some
519
- // internal race condition. If contextmenu is preventDefaulted, then
520
- // mouseup always fires.
521
- //
522
- // On Mac, it always fires mouseup and then fires a click.
523
- result &= goog.testing.events.fireMouseUpEvent(target,
524
- button, opt_coords, props);
525
-
526
- if (goog.userAgent.WEBKIT && goog.userAgent.MAC) {
527
- result &= goog.testing.events.fireClickEvent(
528
- target, button, opt_coords, props);
529
- }
530
- }
531
- return !!result;
532
- };
533
-
534
-
535
- /**
536
- * Simulates a popstate event on the given target.
537
- * @param {EventTarget} target The target for the event.
538
- * @param {Object} state History state object.
539
- * @return {boolean} The returnValue of the event: false if preventDefault() was
540
- * called on it, true otherwise.
541
- */
542
- goog.testing.events.firePopStateEvent = function(target, state) {
543
- var e = new goog.testing.events.Event(goog.events.EventType.POPSTATE, target);
544
- e.state = state;
545
- return goog.testing.events.fireBrowserEvent(e);
546
- };
547
-
548
-
549
- /**
550
- * Simulate a blur event on the given target.
551
- * @param {EventTarget} target The target for the event.
552
- * @return {boolean} The value returned by firing the blur browser event,
553
- * which returns false iff 'preventDefault' was invoked.
554
- */
555
- goog.testing.events.fireBlurEvent = function(target) {
556
- var e = new goog.testing.events.Event(
557
- goog.events.EventType.BLUR, target);
558
- return goog.testing.events.fireBrowserEvent(e);
559
- };
560
-
561
-
562
- /**
563
- * Simulate a focus event on the given target.
564
- * @param {EventTarget} target The target for the event.
565
- * @return {boolean} The value returned by firing the focus browser event,
566
- * which returns false iff 'preventDefault' was invoked.
567
- */
568
- goog.testing.events.fireFocusEvent = function(target) {
569
- var e = new goog.testing.events.Event(
570
- goog.events.EventType.FOCUS, target);
571
- return goog.testing.events.fireBrowserEvent(e);
572
- };
573
-
574
-
575
- /**
576
- * Simulates an event's capturing and bubbling phases.
577
- * @param {Event} event A simulated native event. It will be wrapped in a
578
- * normalized BrowserEvent and dispatched to Closure listeners on all
579
- * ancestors of its target (inclusive).
580
- * @return {boolean} The returnValue of the event: false if preventDefault() was
581
- * called on it, true otherwise.
582
- */
583
- goog.testing.events.fireBrowserEvent = function(event) {
584
- event.returnValue_ = true;
585
-
586
- // generate a list of ancestors
587
- var ancestors = [];
588
- for (var current = event.target; current; current = current.parentNode) {
589
- ancestors.push(current);
590
- }
591
-
592
- // dispatch capturing listeners
593
- for (var j = ancestors.length - 1;
594
- j >= 0 && !event.propagationStopped_;
595
- j--) {
596
- goog.events.fireListeners(ancestors[j], event.type, true,
597
- new goog.events.BrowserEvent(event, ancestors[j]));
598
- }
599
-
600
- // dispatch bubbling listeners
601
- for (var j = 0;
602
- j < ancestors.length && !event.propagationStopped_;
603
- j++) {
604
- goog.events.fireListeners(ancestors[j], event.type, false,
605
- new goog.events.BrowserEvent(event, ancestors[j]));
606
- }
607
-
608
- return event.returnValue_;
609
- };
610
-
611
-
612
- /**
613
- * Simulates a touchstart event on the given target.
614
- * @param {EventTarget} target The target for the event.
615
- * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
616
- * target's position (if available), otherwise (0, 0).
617
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
618
- * BrowserEvent.
619
- * @return {boolean} The returnValue of the event: false if preventDefault() was
620
- * called on it, true otherwise.
621
- */
622
- goog.testing.events.fireTouchStartEvent = function(
623
- target, opt_coords, opt_eventProperties) {
624
- // TODO: Support multi-touch events with array of coordinates.
625
- var touchstart =
626
- new goog.testing.events.Event(goog.events.EventType.TOUCHSTART, target);
627
- goog.testing.events.setEventClientXY_(touchstart, opt_coords);
628
- if (opt_eventProperties) {
629
- goog.object.extend(touchstart, opt_eventProperties);
630
- }
631
- return goog.testing.events.fireBrowserEvent(touchstart);
632
- };
633
-
634
-
635
- /**
636
- * Simulates a touchmove event on the given target.
637
- * @param {EventTarget} target The target for the event.
638
- * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
639
- * target's position (if available), otherwise (0, 0).
640
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
641
- * BrowserEvent.
642
- * @return {boolean} The returnValue of the event: false if preventDefault() was
643
- * called on it, true otherwise.
644
- */
645
- goog.testing.events.fireTouchMoveEvent = function(
646
- target, opt_coords, opt_eventProperties) {
647
- // TODO: Support multi-touch events with array of coordinates.
648
- var touchmove =
649
- new goog.testing.events.Event(goog.events.EventType.TOUCHMOVE, target);
650
- goog.testing.events.setEventClientXY_(touchmove, opt_coords);
651
- if (opt_eventProperties) {
652
- goog.object.extend(touchmove, opt_eventProperties);
653
- }
654
- return goog.testing.events.fireBrowserEvent(touchmove);
655
- };
656
-
657
-
658
- /**
659
- * Simulates a touchend event on the given target.
660
- * @param {EventTarget} target The target for the event.
661
- * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
662
- * target's position (if available), otherwise (0, 0).
663
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
664
- * BrowserEvent.
665
- * @return {boolean} The returnValue of the event: false if preventDefault() was
666
- * called on it, true otherwise.
667
- */
668
- goog.testing.events.fireTouchEndEvent = function(
669
- target, opt_coords, opt_eventProperties) {
670
- // TODO: Support multi-touch events with array of coordinates.
671
- var touchend =
672
- new goog.testing.events.Event(goog.events.EventType.TOUCHEND, target);
673
- goog.testing.events.setEventClientXY_(touchend, opt_coords);
674
- if (opt_eventProperties) {
675
- goog.object.extend(touchend, opt_eventProperties);
676
- }
677
- return goog.testing.events.fireBrowserEvent(touchend);
678
- };
679
-
680
-
681
- /**
682
- * Simulates a simple touch sequence on the given target.
683
- * @param {EventTarget} target The target for the event.
684
- * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event
685
- * target's position (if available), otherwise (0, 0).
686
- * @param {Object=} opt_eventProperties Event properties to be mixed into the
687
- * BrowserEvent.
688
- * @return {boolean} The returnValue of the sequence: false if preventDefault()
689
- * was called on any of the events, true otherwise.
690
- */
691
- goog.testing.events.fireTouchSequence = function(
692
- target, opt_coords, opt_eventProperties) {
693
- // TODO: Support multi-touch events with array of coordinates.
694
- // Fire touchstart, touchmove, touchend then return the bitwise AND of the 3.
695
- return !!(goog.testing.events.fireTouchStartEvent(
696
- target, opt_coords, opt_eventProperties) &
697
- goog.testing.events.fireTouchEndEvent(
698
- target, opt_coords, opt_eventProperties));
699
- };
700
-
701
-
702
- /**
703
- * Mixins a listenable into the given object. This turns the object
704
- * into a goog.events.Listenable. This is useful, for example, when
705
- * you need to mock a implementation of listenable and still want it
706
- * to work with goog.events.
707
- * @param {!Object} obj The object to mixin into.
708
- */
709
- goog.testing.events.mixinListenable = function(obj) {
710
- var listenable = new goog.events.EventTarget();
711
-
712
- listenable.setTargetForTesting(obj);
713
-
714
- var listenablePrototype = goog.events.EventTarget.prototype;
715
- var disposablePrototype = goog.Disposable.prototype;
716
- for (var key in listenablePrototype) {
717
- if (listenablePrototype.hasOwnProperty(key) ||
718
- disposablePrototype.hasOwnProperty(key)) {
719
- var member = listenablePrototype[key];
720
- if (goog.isFunction(member)) {
721
- obj[key] = goog.bind(member, listenable);
722
- } else {
723
- obj[key] = member;
724
- }
725
- }
726
- }
727
- };