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>eventtype.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/goog/events/eventtype.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Event Types.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<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>goog.provide(&#39;goog.events.EventType&#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>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Returns a prefixed event name for the current browser.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {string} eventName The name of the event.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @return {string} The prefixed event name.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @suppress {missingRequire|missingProvide}<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @private<tr><td><a id="l33"></a><a href="#l33">33</a><td> */<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.events.getVendorPrefixedName_ = function(eventName) {<tr><td><a id="l35"></a><a href="#l35">35</a><td> return goog.userAgent.WEBKIT ? &#39;webkit&#39; + eventName :<tr><td><a id="l36"></a><a href="#l36">36</a><td> (goog.userAgent.OPERA ? &#39;o&#39; + eventName.toLowerCase() :<tr><td><a id="l37"></a><a href="#l37">37</a><td> eventName.toLowerCase());<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> * Constants for event names.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @enum {string}<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.events.EventType = {<tr><td><a id="l46"></a><a href="#l46">46</a><td> // Mouse events<tr><td><a id="l47"></a><a href="#l47">47</a><td> CLICK: &#39;click&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td> RIGHTCLICK: &#39;rightclick&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td> DBLCLICK: &#39;dblclick&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td> MOUSEDOWN: &#39;mousedown&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td> MOUSEUP: &#39;mouseup&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td> MOUSEOVER: &#39;mouseover&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td> MOUSEOUT: &#39;mouseout&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td> MOUSEMOVE: &#39;mousemove&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td> MOUSEENTER: &#39;mouseenter&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td> MOUSELEAVE: &#39;mouseleave&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td> // Select start is non-standard.<tr><td><a id="l58"></a><a href="#l58">58</a><td> // See http://msdn.microsoft.com/en-us/library/ie/ms536969(v=vs.85).aspx.<tr><td><a id="l59"></a><a href="#l59">59</a><td> SELECTSTART: &#39;selectstart&#39;, // IE, Safari, Chrome<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td> // Wheel events<tr><td><a id="l62"></a><a href="#l62">62</a><td> // http://www.w3.org/TR/DOM-Level-3-Events/#events-wheelevents<tr><td><a id="l63"></a><a href="#l63">63</a><td> WHEEL: &#39;wheel&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td> // Key events<tr><td><a id="l66"></a><a href="#l66">66</a><td> KEYPRESS: &#39;keypress&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td> KEYDOWN: &#39;keydown&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td> KEYUP: &#39;keyup&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td> // Focus<tr><td><a id="l71"></a><a href="#l71">71</a><td> BLUR: &#39;blur&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td> FOCUS: &#39;focus&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td> DEACTIVATE: &#39;deactivate&#39;, // IE only<tr><td><a id="l74"></a><a href="#l74">74</a><td> // NOTE: The following two events are not stable in cross-browser usage.<tr><td><a id="l75"></a><a href="#l75">75</a><td> // WebKit and Opera implement DOMFocusIn/Out.<tr><td><a id="l76"></a><a href="#l76">76</a><td> // IE implements focusin/out.<tr><td><a id="l77"></a><a href="#l77">77</a><td> // Gecko implements neither see bug at<tr><td><a id="l78"></a><a href="#l78">78</a><td> // https://bugzilla.mozilla.org/show_bug.cgi?id=396927.<tr><td><a id="l79"></a><a href="#l79">79</a><td> // The DOM Events Level 3 Draft deprecates DOMFocusIn in favor of focusin:<tr><td><a id="l80"></a><a href="#l80">80</a><td> // http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html<tr><td><a id="l81"></a><a href="#l81">81</a><td> // You can use FOCUS in Capture phase until implementations converge.<tr><td><a id="l82"></a><a href="#l82">82</a><td> FOCUSIN: goog.userAgent.IE ? &#39;focusin&#39; : &#39;DOMFocusIn&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td> FOCUSOUT: goog.userAgent.IE ? &#39;focusout&#39; : &#39;DOMFocusOut&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td> // Forms<tr><td><a id="l86"></a><a href="#l86">86</a><td> CHANGE: &#39;change&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td> RESET: &#39;reset&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td> SELECT: &#39;select&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td> SUBMIT: &#39;submit&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td> INPUT: &#39;input&#39;,<tr><td><a id="l91"></a><a href="#l91">91</a><td> PROPERTYCHANGE: &#39;propertychange&#39;, // IE only<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td> // Drag and drop<tr><td><a id="l94"></a><a href="#l94">94</a><td> DRAGSTART: &#39;dragstart&#39;,<tr><td><a id="l95"></a><a href="#l95">95</a><td> DRAG: &#39;drag&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td> DRAGENTER: &#39;dragenter&#39;,<tr><td><a id="l97"></a><a href="#l97">97</a><td> DRAGOVER: &#39;dragover&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td> DRAGLEAVE: &#39;dragleave&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td> DROP: &#39;drop&#39;,<tr><td><a id="l100"></a><a href="#l100">100</a><td> DRAGEND: &#39;dragend&#39;,<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td> // Touch events<tr><td><a id="l103"></a><a href="#l103">103</a><td> // Note that other touch events exist, but we should follow the W3C list here.<tr><td><a id="l104"></a><a href="#l104">104</a><td> // http://www.w3.org/TR/touch-events/#list-of-touchevent-types<tr><td><a id="l105"></a><a href="#l105">105</a><td> TOUCHSTART: &#39;touchstart&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td> TOUCHMOVE: &#39;touchmove&#39;,<tr><td><a id="l107"></a><a href="#l107">107</a><td> TOUCHEND: &#39;touchend&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td> TOUCHCANCEL: &#39;touchcancel&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td> // Misc<tr><td><a id="l111"></a><a href="#l111">111</a><td> BEFOREUNLOAD: &#39;beforeunload&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td> CONSOLEMESSAGE: &#39;consolemessage&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td> CONTEXTMENU: &#39;contextmenu&#39;,<tr><td><a id="l114"></a><a href="#l114">114</a><td> DOMCONTENTLOADED: &#39;DOMContentLoaded&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td> ERROR: &#39;error&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td> HELP: &#39;help&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td> LOAD: &#39;load&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td> LOSECAPTURE: &#39;losecapture&#39;,<tr><td><a id="l119"></a><a href="#l119">119</a><td> ORIENTATIONCHANGE: &#39;orientationchange&#39;,<tr><td><a id="l120"></a><a href="#l120">120</a><td> READYSTATECHANGE: &#39;readystatechange&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td> RESIZE: &#39;resize&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td> SCROLL: &#39;scroll&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td> UNLOAD: &#39;unload&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td> // HTML 5 History events<tr><td><a id="l126"></a><a href="#l126">126</a><td> // See http://www.w3.org/TR/html5/history.html#event-definitions<tr><td><a id="l127"></a><a href="#l127">127</a><td> HASHCHANGE: &#39;hashchange&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td> PAGEHIDE: &#39;pagehide&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td> PAGESHOW: &#39;pageshow&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td> POPSTATE: &#39;popstate&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td> // Copy and Paste<tr><td><a id="l133"></a><a href="#l133">133</a><td> // Support is limited. Make sure it works on your favorite browser<tr><td><a id="l134"></a><a href="#l134">134</a><td> // before using.<tr><td><a id="l135"></a><a href="#l135">135</a><td> // http://www.quirksmode.org/dom/events/cutcopypaste.html<tr><td><a id="l136"></a><a href="#l136">136</a><td> COPY: &#39;copy&#39;,<tr><td><a id="l137"></a><a href="#l137">137</a><td> PASTE: &#39;paste&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td> CUT: &#39;cut&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td> BEFORECOPY: &#39;beforecopy&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td> BEFORECUT: &#39;beforecut&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td> BEFOREPASTE: &#39;beforepaste&#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> // HTML5 online/offline events.<tr><td><a id="l144"></a><a href="#l144">144</a><td> // http://www.w3.org/TR/offline-webapps/#related<tr><td><a id="l145"></a><a href="#l145">145</a><td> ONLINE: &#39;online&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td> OFFLINE: &#39;offline&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td> // HTML 5 worker events<tr><td><a id="l149"></a><a href="#l149">149</a><td> MESSAGE: &#39;message&#39;,<tr><td><a id="l150"></a><a href="#l150">150</a><td> CONNECT: &#39;connect&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td> // CSS animation events.<tr><td><a id="l153"></a><a href="#l153">153</a><td> /** @suppress {missingRequire} */<tr><td><a id="l154"></a><a href="#l154">154</a><td> ANIMATIONSTART: goog.events.getVendorPrefixedName_(&#39;AnimationStart&#39;),<tr><td><a id="l155"></a><a href="#l155">155</a><td> /** @suppress {missingRequire} */<tr><td><a id="l156"></a><a href="#l156">156</a><td> ANIMATIONEND: goog.events.getVendorPrefixedName_(&#39;AnimationEnd&#39;),<tr><td><a id="l157"></a><a href="#l157">157</a><td> /** @suppress {missingRequire} */<tr><td><a id="l158"></a><a href="#l158">158</a><td> ANIMATIONITERATION: goog.events.getVendorPrefixedName_(&#39;AnimationIteration&#39;),<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td> // CSS transition events. Based on the browser support described at:<tr><td><a id="l161"></a><a href="#l161">161</a><td> // https://developer.mozilla.org/en/css/css_transitions#Browser_compatibility<tr><td><a id="l162"></a><a href="#l162">162</a><td> /** @suppress {missingRequire} */<tr><td><a id="l163"></a><a href="#l163">163</a><td> TRANSITIONEND: goog.events.getVendorPrefixedName_(&#39;TransitionEnd&#39;),<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td> // W3C Pointer Events<tr><td><a id="l166"></a><a href="#l166">166</a><td> // http://www.w3.org/TR/pointerevents/<tr><td><a id="l167"></a><a href="#l167">167</a><td> POINTERDOWN: &#39;pointerdown&#39;,<tr><td><a id="l168"></a><a href="#l168">168</a><td> POINTERUP: &#39;pointerup&#39;,<tr><td><a id="l169"></a><a href="#l169">169</a><td> POINTERCANCEL: &#39;pointercancel&#39;,<tr><td><a id="l170"></a><a href="#l170">170</a><td> POINTERMOVE: &#39;pointermove&#39;,<tr><td><a id="l171"></a><a href="#l171">171</a><td> POINTEROVER: &#39;pointerover&#39;,<tr><td><a id="l172"></a><a href="#l172">172</a><td> POINTEROUT: &#39;pointerout&#39;,<tr><td><a id="l173"></a><a href="#l173">173</a><td> POINTERENTER: &#39;pointerenter&#39;,<tr><td><a id="l174"></a><a href="#l174">174</a><td> POINTERLEAVE: &#39;pointerleave&#39;,<tr><td><a id="l175"></a><a href="#l175">175</a><td> GOTPOINTERCAPTURE: &#39;gotpointercapture&#39;,<tr><td><a id="l176"></a><a href="#l176">176</a><td> LOSTPOINTERCAPTURE: &#39;lostpointercapture&#39;,<tr><td><a id="l177"></a><a href="#l177">177</a><td><tr><td><a id="l178"></a><a href="#l178">178</a><td> // IE specific events.<tr><td><a id="l179"></a><a href="#l179">179</a><td> // See http://msdn.microsoft.com/en-us/library/ie/hh772103(v=vs.85).aspx<tr><td><a id="l180"></a><a href="#l180">180</a><td> // Note: these events will be supplanted in IE11.<tr><td><a id="l181"></a><a href="#l181">181</a><td> MSGESTURECHANGE: &#39;MSGestureChange&#39;,<tr><td><a id="l182"></a><a href="#l182">182</a><td> MSGESTUREEND: &#39;MSGestureEnd&#39;,<tr><td><a id="l183"></a><a href="#l183">183</a><td> MSGESTUREHOLD: &#39;MSGestureHold&#39;,<tr><td><a id="l184"></a><a href="#l184">184</a><td> MSGESTURESTART: &#39;MSGestureStart&#39;,<tr><td><a id="l185"></a><a href="#l185">185</a><td> MSGESTURETAP: &#39;MSGestureTap&#39;,<tr><td><a id="l186"></a><a href="#l186">186</a><td> MSGOTPOINTERCAPTURE: &#39;MSGotPointerCapture&#39;,<tr><td><a id="l187"></a><a href="#l187">187</a><td> MSINERTIASTART: &#39;MSInertiaStart&#39;,<tr><td><a id="l188"></a><a href="#l188">188</a><td> MSLOSTPOINTERCAPTURE: &#39;MSLostPointerCapture&#39;,<tr><td><a id="l189"></a><a href="#l189">189</a><td> MSPOINTERCANCEL: &#39;MSPointerCancel&#39;,<tr><td><a id="l190"></a><a href="#l190">190</a><td> MSPOINTERDOWN: &#39;MSPointerDown&#39;,<tr><td><a id="l191"></a><a href="#l191">191</a><td> MSPOINTERENTER: &#39;MSPointerEnter&#39;,<tr><td><a id="l192"></a><a href="#l192">192</a><td> MSPOINTERHOVER: &#39;MSPointerHover&#39;,<tr><td><a id="l193"></a><a href="#l193">193</a><td> MSPOINTERLEAVE: &#39;MSPointerLeave&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td> MSPOINTERMOVE: &#39;MSPointerMove&#39;,<tr><td><a id="l195"></a><a href="#l195">195</a><td> MSPOINTEROUT: &#39;MSPointerOut&#39;,<tr><td><a id="l196"></a><a href="#l196">196</a><td> MSPOINTEROVER: &#39;MSPointerOver&#39;,<tr><td><a id="l197"></a><a href="#l197">197</a><td> MSPOINTERUP: &#39;MSPointerUp&#39;,<tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td> // Native IMEs/input tools events.<tr><td><a id="l200"></a><a href="#l200">200</a><td> TEXT: &#39;text&#39;,<tr><td><a id="l201"></a><a href="#l201">201</a><td> TEXTINPUT: &#39;textInput&#39;,<tr><td><a id="l202"></a><a href="#l202">202</a><td> COMPOSITIONSTART: &#39;compositionstart&#39;,<tr><td><a id="l203"></a><a href="#l203">203</a><td> COMPOSITIONUPDATE: &#39;compositionupdate&#39;,<tr><td><a id="l204"></a><a href="#l204">204</a><td> COMPOSITIONEND: &#39;compositionend&#39;,<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td> // Webview tag events<tr><td><a id="l207"></a><a href="#l207">207</a><td> // See http://developer.chrome.com/dev/apps/webview_tag.html<tr><td><a id="l208"></a><a href="#l208">208</a><td> EXIT: &#39;exit&#39;,<tr><td><a id="l209"></a><a href="#l209">209</a><td> LOADABORT: &#39;loadabort&#39;,<tr><td><a id="l210"></a><a href="#l210">210</a><td> LOADCOMMIT: &#39;loadcommit&#39;,<tr><td><a id="l211"></a><a href="#l211">211</a><td> LOADREDIRECT: &#39;loadredirect&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td> LOADSTART: &#39;loadstart&#39;,<tr><td><a id="l213"></a><a href="#l213">213</a><td> LOADSTOP: &#39;loadstop&#39;,<tr><td><a id="l214"></a><a href="#l214">214</a><td> RESPONSIVE: &#39;responsive&#39;,<tr><td><a id="l215"></a><a href="#l215">215</a><td> SIZECHANGED: &#39;sizechanged&#39;,<tr><td><a id="l216"></a><a href="#l216">216</a><td> UNRESPONSIVE: &#39;unresponsive&#39;,<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td> // HTML5 Page Visibility API. See details at<tr><td><a id="l219"></a><a href="#l219">219</a><td> // {@code goog.labs.dom.PageVisibilityMonitor}.<tr><td><a id="l220"></a><a href="#l220">220</a><td> VISIBILITYCHANGE: &#39;visibilitychange&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td> // LocalStorage event.<tr><td><a id="l223"></a><a href="#l223">223</a><td> STORAGE: &#39;storage&#39;,<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td> // DOM Level 2 mutation events (deprecated).<tr><td><a id="l226"></a><a href="#l226">226</a><td> DOMSUBTREEMODIFIED: &#39;DOMSubtreeModified&#39;,<tr><td><a id="l227"></a><a href="#l227">227</a><td> DOMNODEINSERTED: &#39;DOMNodeInserted&#39;,<tr><td><a id="l228"></a><a href="#l228">228</a><td> DOMNODEREMOVED: &#39;DOMNodeRemoved&#39;,<tr><td><a id="l229"></a><a href="#l229">229</a><td> DOMNODEREMOVEDFROMDOCUMENT: &#39;DOMNodeRemovedFromDocument&#39;,<tr><td><a id="l230"></a><a href="#l230">230</a><td> DOMNODEINSERTEDINTODOCUMENT: &#39;DOMNodeInsertedIntoDocument&#39;,<tr><td><a id="l231"></a><a href="#l231">231</a><td> DOMATTRMODIFIED: &#39;DOMAttrModified&#39;,<tr><td><a id="l232"></a><a href="#l232">232</a><td> DOMCHARACTERDATAMODIFIED: &#39;DOMCharacterDataModified&#39;<tr><td><a id="l233"></a><a href="#l233">233</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>keycodes.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/goog/events/keycodes.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Constant declarations for common key codes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author eae@google.com (Emil A Eklund)<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @see ../demos/keyhandler.html<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.events.KeyCodes&#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>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Key codes for common characters.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * This list is not localized and therefore some of the key codes are not<tr><td><a id="l31"></a><a href="#l31">31</a><td> * correct for non US keyboard layouts. See comments below.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @enum {number}<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.events.KeyCodes = {<tr><td><a id="l36"></a><a href="#l36">36</a><td> WIN_KEY_FF_LINUX: 0,<tr><td><a id="l37"></a><a href="#l37">37</a><td> MAC_ENTER: 3,<tr><td><a id="l38"></a><a href="#l38">38</a><td> BACKSPACE: 8,<tr><td><a id="l39"></a><a href="#l39">39</a><td> TAB: 9,<tr><td><a id="l40"></a><a href="#l40">40</a><td> NUM_CENTER: 12, // NUMLOCK on FF/Safari Mac<tr><td><a id="l41"></a><a href="#l41">41</a><td> ENTER: 13,<tr><td><a id="l42"></a><a href="#l42">42</a><td> SHIFT: 16,<tr><td><a id="l43"></a><a href="#l43">43</a><td> CTRL: 17,<tr><td><a id="l44"></a><a href="#l44">44</a><td> ALT: 18,<tr><td><a id="l45"></a><a href="#l45">45</a><td> PAUSE: 19,<tr><td><a id="l46"></a><a href="#l46">46</a><td> CAPS_LOCK: 20,<tr><td><a id="l47"></a><a href="#l47">47</a><td> ESC: 27,<tr><td><a id="l48"></a><a href="#l48">48</a><td> SPACE: 32,<tr><td><a id="l49"></a><a href="#l49">49</a><td> PAGE_UP: 33, // also NUM_NORTH_EAST<tr><td><a id="l50"></a><a href="#l50">50</a><td> PAGE_DOWN: 34, // also NUM_SOUTH_EAST<tr><td><a id="l51"></a><a href="#l51">51</a><td> END: 35, // also NUM_SOUTH_WEST<tr><td><a id="l52"></a><a href="#l52">52</a><td> HOME: 36, // also NUM_NORTH_WEST<tr><td><a id="l53"></a><a href="#l53">53</a><td> LEFT: 37, // also NUM_WEST<tr><td><a id="l54"></a><a href="#l54">54</a><td> UP: 38, // also NUM_NORTH<tr><td><a id="l55"></a><a href="#l55">55</a><td> RIGHT: 39, // also NUM_EAST<tr><td><a id="l56"></a><a href="#l56">56</a><td> DOWN: 40, // also NUM_SOUTH<tr><td><a id="l57"></a><a href="#l57">57</a><td> PRINT_SCREEN: 44,<tr><td><a id="l58"></a><a href="#l58">58</a><td> INSERT: 45, // also NUM_INSERT<tr><td><a id="l59"></a><a href="#l59">59</a><td> DELETE: 46, // also NUM_DELETE<tr><td><a id="l60"></a><a href="#l60">60</a><td> ZERO: 48,<tr><td><a id="l61"></a><a href="#l61">61</a><td> ONE: 49,<tr><td><a id="l62"></a><a href="#l62">62</a><td> TWO: 50,<tr><td><a id="l63"></a><a href="#l63">63</a><td> THREE: 51,<tr><td><a id="l64"></a><a href="#l64">64</a><td> FOUR: 52,<tr><td><a id="l65"></a><a href="#l65">65</a><td> FIVE: 53,<tr><td><a id="l66"></a><a href="#l66">66</a><td> SIX: 54,<tr><td><a id="l67"></a><a href="#l67">67</a><td> SEVEN: 55,<tr><td><a id="l68"></a><a href="#l68">68</a><td> EIGHT: 56,<tr><td><a id="l69"></a><a href="#l69">69</a><td> NINE: 57,<tr><td><a id="l70"></a><a href="#l70">70</a><td> FF_SEMICOLON: 59, // Firefox (Gecko) fires this for semicolon instead of 186<tr><td><a id="l71"></a><a href="#l71">71</a><td> FF_EQUALS: 61, // Firefox (Gecko) fires this for equals instead of 187<tr><td><a id="l72"></a><a href="#l72">72</a><td> FF_DASH: 173, // Firefox (Gecko) fires this for dash instead of 189<tr><td><a id="l73"></a><a href="#l73">73</a><td> QUESTION_MARK: 63, // needs localization<tr><td><a id="l74"></a><a href="#l74">74</a><td> A: 65,<tr><td><a id="l75"></a><a href="#l75">75</a><td> B: 66,<tr><td><a id="l76"></a><a href="#l76">76</a><td> C: 67,<tr><td><a id="l77"></a><a href="#l77">77</a><td> D: 68,<tr><td><a id="l78"></a><a href="#l78">78</a><td> E: 69,<tr><td><a id="l79"></a><a href="#l79">79</a><td> F: 70,<tr><td><a id="l80"></a><a href="#l80">80</a><td> G: 71,<tr><td><a id="l81"></a><a href="#l81">81</a><td> H: 72,<tr><td><a id="l82"></a><a href="#l82">82</a><td> I: 73,<tr><td><a id="l83"></a><a href="#l83">83</a><td> J: 74,<tr><td><a id="l84"></a><a href="#l84">84</a><td> K: 75,<tr><td><a id="l85"></a><a href="#l85">85</a><td> L: 76,<tr><td><a id="l86"></a><a href="#l86">86</a><td> M: 77,<tr><td><a id="l87"></a><a href="#l87">87</a><td> N: 78,<tr><td><a id="l88"></a><a href="#l88">88</a><td> O: 79,<tr><td><a id="l89"></a><a href="#l89">89</a><td> P: 80,<tr><td><a id="l90"></a><a href="#l90">90</a><td> Q: 81,<tr><td><a id="l91"></a><a href="#l91">91</a><td> R: 82,<tr><td><a id="l92"></a><a href="#l92">92</a><td> S: 83,<tr><td><a id="l93"></a><a href="#l93">93</a><td> T: 84,<tr><td><a id="l94"></a><a href="#l94">94</a><td> U: 85,<tr><td><a id="l95"></a><a href="#l95">95</a><td> V: 86,<tr><td><a id="l96"></a><a href="#l96">96</a><td> W: 87,<tr><td><a id="l97"></a><a href="#l97">97</a><td> X: 88,<tr><td><a id="l98"></a><a href="#l98">98</a><td> Y: 89,<tr><td><a id="l99"></a><a href="#l99">99</a><td> Z: 90,<tr><td><a id="l100"></a><a href="#l100">100</a><td> META: 91, // WIN_KEY_LEFT<tr><td><a id="l101"></a><a href="#l101">101</a><td> WIN_KEY_RIGHT: 92,<tr><td><a id="l102"></a><a href="#l102">102</a><td> CONTEXT_MENU: 93,<tr><td><a id="l103"></a><a href="#l103">103</a><td> NUM_ZERO: 96,<tr><td><a id="l104"></a><a href="#l104">104</a><td> NUM_ONE: 97,<tr><td><a id="l105"></a><a href="#l105">105</a><td> NUM_TWO: 98,<tr><td><a id="l106"></a><a href="#l106">106</a><td> NUM_THREE: 99,<tr><td><a id="l107"></a><a href="#l107">107</a><td> NUM_FOUR: 100,<tr><td><a id="l108"></a><a href="#l108">108</a><td> NUM_FIVE: 101,<tr><td><a id="l109"></a><a href="#l109">109</a><td> NUM_SIX: 102,<tr><td><a id="l110"></a><a href="#l110">110</a><td> NUM_SEVEN: 103,<tr><td><a id="l111"></a><a href="#l111">111</a><td> NUM_EIGHT: 104,<tr><td><a id="l112"></a><a href="#l112">112</a><td> NUM_NINE: 105,<tr><td><a id="l113"></a><a href="#l113">113</a><td> NUM_MULTIPLY: 106,<tr><td><a id="l114"></a><a href="#l114">114</a><td> NUM_PLUS: 107,<tr><td><a id="l115"></a><a href="#l115">115</a><td> NUM_MINUS: 109,<tr><td><a id="l116"></a><a href="#l116">116</a><td> NUM_PERIOD: 110,<tr><td><a id="l117"></a><a href="#l117">117</a><td> NUM_DIVISION: 111,<tr><td><a id="l118"></a><a href="#l118">118</a><td> F1: 112,<tr><td><a id="l119"></a><a href="#l119">119</a><td> F2: 113,<tr><td><a id="l120"></a><a href="#l120">120</a><td> F3: 114,<tr><td><a id="l121"></a><a href="#l121">121</a><td> F4: 115,<tr><td><a id="l122"></a><a href="#l122">122</a><td> F5: 116,<tr><td><a id="l123"></a><a href="#l123">123</a><td> F6: 117,<tr><td><a id="l124"></a><a href="#l124">124</a><td> F7: 118,<tr><td><a id="l125"></a><a href="#l125">125</a><td> F8: 119,<tr><td><a id="l126"></a><a href="#l126">126</a><td> F9: 120,<tr><td><a id="l127"></a><a href="#l127">127</a><td> F10: 121,<tr><td><a id="l128"></a><a href="#l128">128</a><td> F11: 122,<tr><td><a id="l129"></a><a href="#l129">129</a><td> F12: 123,<tr><td><a id="l130"></a><a href="#l130">130</a><td> NUMLOCK: 144,<tr><td><a id="l131"></a><a href="#l131">131</a><td> SCROLL_LOCK: 145,<tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td> // OS-specific media keys like volume controls and browser controls.<tr><td><a id="l134"></a><a href="#l134">134</a><td> FIRST_MEDIA_KEY: 166,<tr><td><a id="l135"></a><a href="#l135">135</a><td> LAST_MEDIA_KEY: 183,<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td> SEMICOLON: 186, // needs localization<tr><td><a id="l138"></a><a href="#l138">138</a><td> DASH: 189, // needs localization<tr><td><a id="l139"></a><a href="#l139">139</a><td> EQUALS: 187, // needs localization<tr><td><a id="l140"></a><a href="#l140">140</a><td> COMMA: 188, // needs localization<tr><td><a id="l141"></a><a href="#l141">141</a><td> PERIOD: 190, // needs localization<tr><td><a id="l142"></a><a href="#l142">142</a><td> SLASH: 191, // needs localization<tr><td><a id="l143"></a><a href="#l143">143</a><td> APOSTROPHE: 192, // needs localization<tr><td><a id="l144"></a><a href="#l144">144</a><td> TILDE: 192, // needs localization<tr><td><a id="l145"></a><a href="#l145">145</a><td> SINGLE_QUOTE: 222, // needs localization<tr><td><a id="l146"></a><a href="#l146">146</a><td> OPEN_SQUARE_BRACKET: 219, // needs localization<tr><td><a id="l147"></a><a href="#l147">147</a><td> BACKSLASH: 220, // needs localization<tr><td><a id="l148"></a><a href="#l148">148</a><td> CLOSE_SQUARE_BRACKET: 221, // needs localization<tr><td><a id="l149"></a><a href="#l149">149</a><td> WIN_KEY: 224,<tr><td><a id="l150"></a><a href="#l150">150</a><td> MAC_FF_META: 224, // Firefox (Gecko) fires this for the meta key instead of 91<tr><td><a id="l151"></a><a href="#l151">151</a><td> MAC_WK_CMD_LEFT: 91, // WebKit Left Command key fired, same as META<tr><td><a id="l152"></a><a href="#l152">152</a><td> MAC_WK_CMD_RIGHT: 93, // WebKit Right Command key fired, different from META<tr><td><a id="l153"></a><a href="#l153">153</a><td> WIN_IME: 229,<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td> // &quot;Reserved for future use&quot;. Some programs (e.g. the SlingPlayer 2.4 ActiveX<tr><td><a id="l156"></a><a href="#l156">156</a><td> // control) fire this as a hacky way to disable screensavers.<tr><td><a id="l157"></a><a href="#l157">157</a><td> VK_NONAME: 252,<tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td> // We&#39;ve seen users whose machines fire this keycode at regular one<tr><td><a id="l160"></a><a href="#l160">160</a><td> // second intervals. The common thread among these users is that<tr><td><a id="l161"></a><a href="#l161">161</a><td> // they&#39;re all using Dell Inspiron laptops, so we suspect that this<tr><td><a id="l162"></a><a href="#l162">162</a><td> // indicates a hardware/bios problem.<tr><td><a id="l163"></a><a href="#l163">163</a><td> // http://en.community.dell.com/support-forums/laptop/f/3518/p/19285957/19523128.aspx<tr><td><a id="l164"></a><a href="#l164">164</a><td> PHANTOM: 255<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> * Returns true if the event contains a text modifying key.<tr><td><a id="l170"></a><a href="#l170">170</a><td> * @param {goog.events.BrowserEvent} e A key event.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @return {boolean} Whether it&#39;s a text modifying key.<tr><td><a id="l172"></a><a href="#l172">172</a><td> */<tr><td><a id="l173"></a><a href="#l173">173</a><td>goog.events.KeyCodes.isTextModifyingKeyEvent = function(e) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> if (e.altKey &amp;&amp; !e.ctrlKey ||<tr><td><a id="l175"></a><a href="#l175">175</a><td> e.metaKey ||<tr><td><a id="l176"></a><a href="#l176">176</a><td> // Function keys don&#39;t generate text<tr><td><a id="l177"></a><a href="#l177">177</a><td> e.keyCode &gt;= goog.events.KeyCodes.F1 &amp;&amp;<tr><td><a id="l178"></a><a href="#l178">178</a><td> e.keyCode &lt;= goog.events.KeyCodes.F12) {<tr><td><a id="l179"></a><a href="#l179">179</a><td> return false;<tr><td><a id="l180"></a><a href="#l180">180</a><td> }<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td> // The following keys are quite harmless, even in combination with<tr><td><a id="l183"></a><a href="#l183">183</a><td> // CTRL, ALT or SHIFT.<tr><td><a id="l184"></a><a href="#l184">184</a><td> switch (e.keyCode) {<tr><td><a id="l185"></a><a href="#l185">185</a><td> case goog.events.KeyCodes.ALT:<tr><td><a id="l186"></a><a href="#l186">186</a><td> case goog.events.KeyCodes.CAPS_LOCK:<tr><td><a id="l187"></a><a href="#l187">187</a><td> case goog.events.KeyCodes.CONTEXT_MENU:<tr><td><a id="l188"></a><a href="#l188">188</a><td> case goog.events.KeyCodes.CTRL:<tr><td><a id="l189"></a><a href="#l189">189</a><td> case goog.events.KeyCodes.DOWN:<tr><td><a id="l190"></a><a href="#l190">190</a><td> case goog.events.KeyCodes.END:<tr><td><a id="l191"></a><a href="#l191">191</a><td> case goog.events.KeyCodes.ESC:<tr><td><a id="l192"></a><a href="#l192">192</a><td> case goog.events.KeyCodes.HOME:<tr><td><a id="l193"></a><a href="#l193">193</a><td> case goog.events.KeyCodes.INSERT:<tr><td><a id="l194"></a><a href="#l194">194</a><td> case goog.events.KeyCodes.LEFT:<tr><td><a id="l195"></a><a href="#l195">195</a><td> case goog.events.KeyCodes.MAC_FF_META:<tr><td><a id="l196"></a><a href="#l196">196</a><td> case goog.events.KeyCodes.META:<tr><td><a id="l197"></a><a href="#l197">197</a><td> case goog.events.KeyCodes.NUMLOCK:<tr><td><a id="l198"></a><a href="#l198">198</a><td> case goog.events.KeyCodes.NUM_CENTER:<tr><td><a id="l199"></a><a href="#l199">199</a><td> case goog.events.KeyCodes.PAGE_DOWN:<tr><td><a id="l200"></a><a href="#l200">200</a><td> case goog.events.KeyCodes.PAGE_UP:<tr><td><a id="l201"></a><a href="#l201">201</a><td> case goog.events.KeyCodes.PAUSE:<tr><td><a id="l202"></a><a href="#l202">202</a><td> case goog.events.KeyCodes.PHANTOM:<tr><td><a id="l203"></a><a href="#l203">203</a><td> case goog.events.KeyCodes.PRINT_SCREEN:<tr><td><a id="l204"></a><a href="#l204">204</a><td> case goog.events.KeyCodes.RIGHT:<tr><td><a id="l205"></a><a href="#l205">205</a><td> case goog.events.KeyCodes.SCROLL_LOCK:<tr><td><a id="l206"></a><a href="#l206">206</a><td> case goog.events.KeyCodes.SHIFT:<tr><td><a id="l207"></a><a href="#l207">207</a><td> case goog.events.KeyCodes.UP:<tr><td><a id="l208"></a><a href="#l208">208</a><td> case goog.events.KeyCodes.VK_NONAME:<tr><td><a id="l209"></a><a href="#l209">209</a><td> case goog.events.KeyCodes.WIN_KEY:<tr><td><a id="l210"></a><a href="#l210">210</a><td> case goog.events.KeyCodes.WIN_KEY_RIGHT:<tr><td><a id="l211"></a><a href="#l211">211</a><td> return false;<tr><td><a id="l212"></a><a href="#l212">212</a><td> case goog.events.KeyCodes.WIN_KEY_FF_LINUX:<tr><td><a id="l213"></a><a href="#l213">213</a><td> return !goog.userAgent.GECKO;<tr><td><a id="l214"></a><a href="#l214">214</a><td> default:<tr><td><a id="l215"></a><a href="#l215">215</a><td> return e.keyCode &lt; goog.events.KeyCodes.FIRST_MEDIA_KEY ||<tr><td><a id="l216"></a><a href="#l216">216</a><td> e.keyCode &gt; goog.events.KeyCodes.LAST_MEDIA_KEY;<tr><td><a id="l217"></a><a href="#l217">217</a><td> }<tr><td><a id="l218"></a><a href="#l218">218</a><td>};<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Returns true if the key fires a keypress event in the current browser.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Accoridng to MSDN [1] IE only fires keypress events for the following keys:<tr><td><a id="l225"></a><a href="#l225">225</a><td> * - Letters: A - Z (uppercase and lowercase)<tr><td><a id="l226"></a><a href="#l226">226</a><td> * - Numerals: 0 - 9<tr><td><a id="l227"></a><a href="#l227">227</a><td> * - Symbols: ! @ # $ % ^ &amp; * ( ) _ - + = &lt; [ ] { } , . / ? \ | &#39; ` &quot; ~<tr><td><a id="l228"></a><a href="#l228">228</a><td> * - System: ESC, SPACEBAR, ENTER<tr><td><a id="l229"></a><a href="#l229">229</a><td> *<tr><td><a id="l230"></a><a href="#l230">230</a><td> * That&#39;s not entirely correct though, for instance there&#39;s no distinction<tr><td><a id="l231"></a><a href="#l231">231</a><td> * between upper and lower case letters.<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * [1] http://msdn2.microsoft.com/en-us/library/ms536939(VS.85).aspx)<tr><td><a id="l234"></a><a href="#l234">234</a><td> *<tr><td><a id="l235"></a><a href="#l235">235</a><td> * Safari is similar to IE, but does not fire keypress for ESC.<tr><td><a id="l236"></a><a href="#l236">236</a><td> *<tr><td><a id="l237"></a><a href="#l237">237</a><td> * Additionally, IE6 does not fire keydown or keypress events for letters when<tr><td><a id="l238"></a><a href="#l238">238</a><td> * the control or alt keys are held down and the shift key is not. IE7 does<tr><td><a id="l239"></a><a href="#l239">239</a><td> * fire keydown in these cases, though, but not keypress.<tr><td><a id="l240"></a><a href="#l240">240</a><td> *<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {number} keyCode A key code.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {number=} opt_heldKeyCode Key code of a currently-held key.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {boolean=} opt_shiftKey Whether the shift key is held down.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {boolean=} opt_ctrlKey Whether the control key is held down.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {boolean=} opt_altKey Whether the alt key is held down.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @return {boolean} Whether it&#39;s a key that fires a keypress event.<tr><td><a id="l247"></a><a href="#l247">247</a><td> */<tr><td><a id="l248"></a><a href="#l248">248</a><td>goog.events.KeyCodes.firesKeyPressEvent = function(keyCode, opt_heldKeyCode,<tr><td><a id="l249"></a><a href="#l249">249</a><td> opt_shiftKey, opt_ctrlKey, opt_altKey) {<tr><td><a id="l250"></a><a href="#l250">250</a><td> if (!goog.userAgent.IE &amp;&amp;<tr><td><a id="l251"></a><a href="#l251">251</a><td> !(goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;525&#39;))) {<tr><td><a id="l252"></a><a href="#l252">252</a><td> return true;<tr><td><a id="l253"></a><a href="#l253">253</a><td> }<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td> if (goog.userAgent.MAC &amp;&amp; opt_altKey) {<tr><td><a id="l256"></a><a href="#l256">256</a><td> return goog.events.KeyCodes.isCharacterKey(keyCode);<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> // Alt but not AltGr which is represented as Alt+Ctrl.<tr><td><a id="l260"></a><a href="#l260">260</a><td> if (opt_altKey &amp;&amp; !opt_ctrlKey) {<tr><td><a id="l261"></a><a href="#l261">261</a><td> return false;<tr><td><a id="l262"></a><a href="#l262">262</a><td> }<tr><td><a id="l263"></a><a href="#l263">263</a><td><tr><td><a id="l264"></a><a href="#l264">264</a><td> // Saves Ctrl or Alt + key for IE and WebKit 525+, which won&#39;t fire keypress.<tr><td><a id="l265"></a><a href="#l265">265</a><td> // Non-IE browsers and WebKit prior to 525 won&#39;t get this far so no need to<tr><td><a id="l266"></a><a href="#l266">266</a><td> // check the user agent.<tr><td><a id="l267"></a><a href="#l267">267</a><td> if (goog.isNumber(opt_heldKeyCode)) {<tr><td><a id="l268"></a><a href="#l268">268</a><td> opt_heldKeyCode = goog.events.KeyCodes.normalizeKeyCode(opt_heldKeyCode);<tr><td><a id="l269"></a><a href="#l269">269</a><td> }<tr><td><a id="l270"></a><a href="#l270">270</a><td> if (!opt_shiftKey &amp;&amp;<tr><td><a id="l271"></a><a href="#l271">271</a><td> (opt_heldKeyCode == goog.events.KeyCodes.CTRL ||<tr><td><a id="l272"></a><a href="#l272">272</a><td> opt_heldKeyCode == goog.events.KeyCodes.ALT ||<tr><td><a id="l273"></a><a href="#l273">273</a><td> goog.userAgent.MAC &amp;&amp;<tr><td><a id="l274"></a><a href="#l274">274</a><td> opt_heldKeyCode == goog.events.KeyCodes.META)) {<tr><td><a id="l275"></a><a href="#l275">275</a><td> return false;<tr><td><a id="l276"></a><a href="#l276">276</a><td> }<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td> // Some keys with Ctrl/Shift do not issue keypress in WEBKIT.<tr><td><a id="l279"></a><a href="#l279">279</a><td> if (goog.userAgent.WEBKIT &amp;&amp; opt_ctrlKey &amp;&amp; opt_shiftKey) {<tr><td><a id="l280"></a><a href="#l280">280</a><td> switch (keyCode) {<tr><td><a id="l281"></a><a href="#l281">281</a><td> case goog.events.KeyCodes.BACKSLASH:<tr><td><a id="l282"></a><a href="#l282">282</a><td> case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:<tr><td><a id="l283"></a><a href="#l283">283</a><td> case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:<tr><td><a id="l284"></a><a href="#l284">284</a><td> case goog.events.KeyCodes.TILDE:<tr><td><a id="l285"></a><a href="#l285">285</a><td> case goog.events.KeyCodes.SEMICOLON:<tr><td><a id="l286"></a><a href="#l286">286</a><td> case goog.events.KeyCodes.DASH:<tr><td><a id="l287"></a><a href="#l287">287</a><td> case goog.events.KeyCodes.EQUALS:<tr><td><a id="l288"></a><a href="#l288">288</a><td> case goog.events.KeyCodes.COMMA:<tr><td><a id="l289"></a><a href="#l289">289</a><td> case goog.events.KeyCodes.PERIOD:<tr><td><a id="l290"></a><a href="#l290">290</a><td> case goog.events.KeyCodes.SLASH:<tr><td><a id="l291"></a><a href="#l291">291</a><td> case goog.events.KeyCodes.APOSTROPHE:<tr><td><a id="l292"></a><a href="#l292">292</a><td> case goog.events.KeyCodes.SINGLE_QUOTE:<tr><td><a id="l293"></a><a href="#l293">293</a><td> return false;<tr><td><a id="l294"></a><a href="#l294">294</a><td> }<tr><td><a id="l295"></a><a href="#l295">295</a><td> }<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td> // When Ctrl+&lt;somekey&gt; is held in IE, it only fires a keypress once, but it<tr><td><a id="l298"></a><a href="#l298">298</a><td> // continues to fire keydown events as the event repeats.<tr><td><a id="l299"></a><a href="#l299">299</a><td> if (goog.userAgent.IE &amp;&amp; opt_ctrlKey &amp;&amp; opt_heldKeyCode == keyCode) {<tr><td><a id="l300"></a><a href="#l300">300</a><td> return false;<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> switch (keyCode) {<tr><td><a id="l304"></a><a href="#l304">304</a><td> case goog.events.KeyCodes.ENTER:<tr><td><a id="l305"></a><a href="#l305">305</a><td> return true;<tr><td><a id="l306"></a><a href="#l306">306</a><td> case goog.events.KeyCodes.ESC:<tr><td><a id="l307"></a><a href="#l307">307</a><td> return !goog.userAgent.WEBKIT;<tr><td><a id="l308"></a><a href="#l308">308</a><td> }<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td> return goog.events.KeyCodes.isCharacterKey(keyCode);<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> * Returns true if the key produces a character.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * This does not cover characters on non-US keyboards (Russian, Hebrew, etc.).<tr><td><a id="l317"></a><a href="#l317">317</a><td> *<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @param {number} keyCode A key code.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @return {boolean} Whether it&#39;s a character key.<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>goog.events.KeyCodes.isCharacterKey = function(keyCode) {<tr><td><a id="l322"></a><a href="#l322">322</a><td> if (keyCode &gt;= goog.events.KeyCodes.ZERO &amp;&amp;<tr><td><a id="l323"></a><a href="#l323">323</a><td> keyCode &lt;= goog.events.KeyCodes.NINE) {<tr><td><a id="l324"></a><a href="#l324">324</a><td> return true;<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> if (keyCode &gt;= goog.events.KeyCodes.NUM_ZERO &amp;&amp;<tr><td><a id="l328"></a><a href="#l328">328</a><td> keyCode &lt;= goog.events.KeyCodes.NUM_MULTIPLY) {<tr><td><a id="l329"></a><a href="#l329">329</a><td> return true;<tr><td><a id="l330"></a><a href="#l330">330</a><td> }<tr><td><a id="l331"></a><a href="#l331">331</a><td><tr><td><a id="l332"></a><a href="#l332">332</a><td> if (keyCode &gt;= goog.events.KeyCodes.A &amp;&amp;<tr><td><a id="l333"></a><a href="#l333">333</a><td> keyCode &lt;= goog.events.KeyCodes.Z) {<tr><td><a id="l334"></a><a href="#l334">334</a><td> return true;<tr><td><a id="l335"></a><a href="#l335">335</a><td> }<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td> // Safari sends zero key code for non-latin characters.<tr><td><a id="l338"></a><a href="#l338">338</a><td> if (goog.userAgent.WEBKIT &amp;&amp; keyCode == 0) {<tr><td><a id="l339"></a><a href="#l339">339</a><td> return true;<tr><td><a id="l340"></a><a href="#l340">340</a><td> }<tr><td><a id="l341"></a><a href="#l341">341</a><td><tr><td><a id="l342"></a><a href="#l342">342</a><td> switch (keyCode) {<tr><td><a id="l343"></a><a href="#l343">343</a><td> case goog.events.KeyCodes.SPACE:<tr><td><a id="l344"></a><a href="#l344">344</a><td> case goog.events.KeyCodes.QUESTION_MARK:<tr><td><a id="l345"></a><a href="#l345">345</a><td> case goog.events.KeyCodes.NUM_PLUS:<tr><td><a id="l346"></a><a href="#l346">346</a><td> case goog.events.KeyCodes.NUM_MINUS:<tr><td><a id="l347"></a><a href="#l347">347</a><td> case goog.events.KeyCodes.NUM_PERIOD:<tr><td><a id="l348"></a><a href="#l348">348</a><td> case goog.events.KeyCodes.NUM_DIVISION:<tr><td><a id="l349"></a><a href="#l349">349</a><td> case goog.events.KeyCodes.SEMICOLON:<tr><td><a id="l350"></a><a href="#l350">350</a><td> case goog.events.KeyCodes.FF_SEMICOLON:<tr><td><a id="l351"></a><a href="#l351">351</a><td> case goog.events.KeyCodes.DASH:<tr><td><a id="l352"></a><a href="#l352">352</a><td> case goog.events.KeyCodes.EQUALS:<tr><td><a id="l353"></a><a href="#l353">353</a><td> case goog.events.KeyCodes.FF_EQUALS:<tr><td><a id="l354"></a><a href="#l354">354</a><td> case goog.events.KeyCodes.COMMA:<tr><td><a id="l355"></a><a href="#l355">355</a><td> case goog.events.KeyCodes.PERIOD:<tr><td><a id="l356"></a><a href="#l356">356</a><td> case goog.events.KeyCodes.SLASH:<tr><td><a id="l357"></a><a href="#l357">357</a><td> case goog.events.KeyCodes.APOSTROPHE:<tr><td><a id="l358"></a><a href="#l358">358</a><td> case goog.events.KeyCodes.SINGLE_QUOTE:<tr><td><a id="l359"></a><a href="#l359">359</a><td> case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:<tr><td><a id="l360"></a><a href="#l360">360</a><td> case goog.events.KeyCodes.BACKSLASH:<tr><td><a id="l361"></a><a href="#l361">361</a><td> case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:<tr><td><a id="l362"></a><a href="#l362">362</a><td> return true;<tr><td><a id="l363"></a><a href="#l363">363</a><td> default:<tr><td><a id="l364"></a><a href="#l364">364</a><td> return false;<tr><td><a id="l365"></a><a href="#l365">365</a><td> }<tr><td><a id="l366"></a><a href="#l366">366</a><td>};<tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td>/**<tr><td><a id="l370"></a><a href="#l370">370</a><td> * Normalizes key codes from OS/Browser-specific value to the general one.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @return {number} The normalized key code.<tr><td><a id="l373"></a><a href="#l373">373</a><td> */<tr><td><a id="l374"></a><a href="#l374">374</a><td>goog.events.KeyCodes.normalizeKeyCode = function(keyCode) {<tr><td><a id="l375"></a><a href="#l375">375</a><td> if (goog.userAgent.GECKO) {<tr><td><a id="l376"></a><a href="#l376">376</a><td> return goog.events.KeyCodes.normalizeGeckoKeyCode(keyCode);<tr><td><a id="l377"></a><a href="#l377">377</a><td> } else if (goog.userAgent.MAC &amp;&amp; goog.userAgent.WEBKIT) {<tr><td><a id="l378"></a><a href="#l378">378</a><td> return goog.events.KeyCodes.normalizeMacWebKitKeyCode(keyCode);<tr><td><a id="l379"></a><a href="#l379">379</a><td> } else {<tr><td><a id="l380"></a><a href="#l380">380</a><td> return keyCode;<tr><td><a id="l381"></a><a href="#l381">381</a><td> }<tr><td><a id="l382"></a><a href="#l382">382</a><td>};<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> * Normalizes key codes from their Gecko-specific value to the general one.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {number} The normalized key code.<tr><td><a id="l389"></a><a href="#l389">389</a><td> */<tr><td><a id="l390"></a><a href="#l390">390</a><td>goog.events.KeyCodes.normalizeGeckoKeyCode = function(keyCode) {<tr><td><a id="l391"></a><a href="#l391">391</a><td> switch (keyCode) {<tr><td><a id="l392"></a><a href="#l392">392</a><td> case goog.events.KeyCodes.FF_EQUALS:<tr><td><a id="l393"></a><a href="#l393">393</a><td> return goog.events.KeyCodes.EQUALS;<tr><td><a id="l394"></a><a href="#l394">394</a><td> case goog.events.KeyCodes.FF_SEMICOLON:<tr><td><a id="l395"></a><a href="#l395">395</a><td> return goog.events.KeyCodes.SEMICOLON;<tr><td><a id="l396"></a><a href="#l396">396</a><td> case goog.events.KeyCodes.FF_DASH:<tr><td><a id="l397"></a><a href="#l397">397</a><td> return goog.events.KeyCodes.DASH;<tr><td><a id="l398"></a><a href="#l398">398</a><td> case goog.events.KeyCodes.MAC_FF_META:<tr><td><a id="l399"></a><a href="#l399">399</a><td> return goog.events.KeyCodes.META;<tr><td><a id="l400"></a><a href="#l400">400</a><td> case goog.events.KeyCodes.WIN_KEY_FF_LINUX:<tr><td><a id="l401"></a><a href="#l401">401</a><td> return goog.events.KeyCodes.WIN_KEY;<tr><td><a id="l402"></a><a href="#l402">402</a><td> default:<tr><td><a id="l403"></a><a href="#l403">403</a><td> return keyCode;<tr><td><a id="l404"></a><a href="#l404">404</a><td> }<tr><td><a id="l405"></a><a href="#l405">405</a><td>};<tr><td><a id="l406"></a><a href="#l406">406</a><td><tr><td><a id="l407"></a><a href="#l407">407</a><td><tr><td><a id="l408"></a><a href="#l408">408</a><td>/**<tr><td><a id="l409"></a><a href="#l409">409</a><td> * Normalizes key codes from their Mac WebKit-specific value to the general one.<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @return {number} The normalized key code.<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>goog.events.KeyCodes.normalizeMacWebKitKeyCode = function(keyCode) {<tr><td><a id="l414"></a><a href="#l414">414</a><td> switch (keyCode) {<tr><td><a id="l415"></a><a href="#l415">415</a><td> case goog.events.KeyCodes.MAC_WK_CMD_RIGHT: // 93<tr><td><a id="l416"></a><a href="#l416">416</a><td> return goog.events.KeyCodes.META; // 91<tr><td><a id="l417"></a><a href="#l417">417</a><td> default:<tr><td><a id="l418"></a><a href="#l418">418</a><td> return keyCode;<tr><td><a id="l419"></a><a href="#l419">419</a><td> }<tr><td><a id="l420"></a><a href="#l420">420</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>listenable.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/goog/events/listenable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview An interface for a listenable JavaScript object.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author chrishenry@google.com (Chris Henry)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<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.provide(&#39;goog.events.Listenable&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.ListenableKey&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @suppress {extraRequire} */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.events.EventId&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * A listenable interface. A listenable is an object with the ability<tr><td><a id="l30"></a><a href="#l30">30</a><td> * to dispatch/broadcast events to &quot;event listeners&quot; registered via<tr><td><a id="l31"></a><a href="#l31">31</a><td> * listen/listenOnce.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * The interface allows for an event propagation mechanism similar<tr><td><a id="l34"></a><a href="#l34">34</a><td> * to one offered by native browser event targets, such as<tr><td><a id="l35"></a><a href="#l35">35</a><td> * capture/bubble mechanism, stopping propagation, and preventing<tr><td><a id="l36"></a><a href="#l36">36</a><td> * default actions. Capture/bubble mechanism depends on the ancestor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * tree constructed via {@code #getParentEventTarget}; this tree<tr><td><a id="l38"></a><a href="#l38">38</a><td> * must be directed acyclic graph. The meaning of default action(s)<tr><td><a id="l39"></a><a href="#l39">39</a><td> * in preventDefault is specific to a particular use case.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Implementations that do not support capture/bubble or can not have<tr><td><a id="l42"></a><a href="#l42">42</a><td> * a parent listenable can simply not implement any ability to set the<tr><td><a id="l43"></a><a href="#l43">43</a><td> * parent listenable (and have {@code #getParentEventTarget} return<tr><td><a id="l44"></a><a href="#l44">44</a><td> * null).<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Implementation of this class can be used with or independently from<tr><td><a id="l47"></a><a href="#l47">47</a><td> * goog.events.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Implementation must call {@code #addImplementation(implClass)}.<tr><td><a id="l50"></a><a href="#l50">50</a><td> *<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @interface<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @see goog.events<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @see http://www.w3.org/TR/DOM-Level-2-Events/events.html<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.events.Listenable = function() {};<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>/**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * An expando property to indicate that an object implements<tr><td><a id="l60"></a><a href="#l60">60</a><td> * goog.events.Listenable.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * See addImplementation/isImplementedBy.<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @type {string}<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @const<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.events.Listenable.IMPLEMENTED_BY_PROP =<tr><td><a id="l68"></a><a href="#l68">68</a><td> &#39;closure_listenable_&#39; + ((Math.random() * 1e6) | 0);<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> * Marks a given class (constructor) as an implementation of<tr><td><a id="l73"></a><a href="#l73">73</a><td> * Listenable, do that we can query that fact at runtime. The class<tr><td><a id="l74"></a><a href="#l74">74</a><td> * must have already implemented the interface.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!Function} cls The class constructor. The corresponding<tr><td><a id="l76"></a><a href="#l76">76</a><td> * class must have already implemented the interface.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.events.Listenable.addImplementation = function(cls) {<tr><td><a id="l79"></a><a href="#l79">79</a><td> cls.prototype[goog.events.Listenable.IMPLEMENTED_BY_PROP] = true;<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> * @param {Object} obj The object to check.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {boolean} Whether a given instance implements Listenable. The<tr><td><a id="l86"></a><a href="#l86">86</a><td> * class/superclass of the instance must call addImplementation.<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.events.Listenable.isImplementedBy = function(obj) {<tr><td><a id="l89"></a><a href="#l89">89</a><td> return !!(obj &amp;&amp; obj[goog.events.Listenable.IMPLEMENTED_BY_PROP]);<tr><td><a id="l90"></a><a href="#l90">90</a><td>};<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td>/**<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Adds an event listener. A listener can only be added once to an<tr><td><a id="l95"></a><a href="#l95">95</a><td> * object and if it is added again the key for the listener is<tr><td><a id="l96"></a><a href="#l96">96</a><td> * returned. Note that if the existing listener is a one-off listener<tr><td><a id="l97"></a><a href="#l97">97</a><td> * (registered via listenOnce), it will no longer be a one-off<tr><td><a id="l98"></a><a href="#l98">98</a><td> * listener after a call to listen().<tr><td><a id="l99"></a><a href="#l99">99</a><td> *<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l102"></a><a href="#l102">102</a><td> * method.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l104"></a><a href="#l104">104</a><td> * (defaults to false).<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l106"></a><a href="#l106">106</a><td> * listener.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.events.Listenable.prototype.listen;<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> * Adds an event listener that is removed automatically after the<tr><td><a id="l115"></a><a href="#l115">115</a><td> * listener fired once.<tr><td><a id="l116"></a><a href="#l116">116</a><td> *<tr><td><a id="l117"></a><a href="#l117">117</a><td> * If an existing listener already exists, listenOnce will do<tr><td><a id="l118"></a><a href="#l118">118</a><td> * nothing. In particular, if the listener was previously registered<tr><td><a id="l119"></a><a href="#l119">119</a><td> * via listen(), listenOnce() will not turn the listener into a<tr><td><a id="l120"></a><a href="#l120">120</a><td> * one-off listener. Similarly, if there is already an existing<tr><td><a id="l121"></a><a href="#l121">121</a><td> * one-off listener, listenOnce does not modify the listeners (it is<tr><td><a id="l122"></a><a href="#l122">122</a><td> * still a once listener).<tr><td><a id="l123"></a><a href="#l123">123</a><td> *<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l126"></a><a href="#l126">126</a><td> * method.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l128"></a><a href="#l128">128</a><td> * (defaults to false).<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l130"></a><a href="#l130">130</a><td> * listener.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l133"></a><a href="#l133">133</a><td> */<tr><td><a id="l134"></a><a href="#l134">134</a><td>goog.events.Listenable.prototype.listenOnce;<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> * Removes an event listener which was added with listen() or listenOnce().<tr><td><a id="l139"></a><a href="#l139">139</a><td> *<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l142"></a><a href="#l142">142</a><td> * method.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l144"></a><a href="#l144">144</a><td> * (defaults to false).<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call<tr><td><a id="l146"></a><a href="#l146">146</a><td> * the listener.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.events.Listenable.prototype.unlisten;<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Removes an event listener which was added with listen() by the key<tr><td><a id="l155"></a><a href="#l155">155</a><td> * returned by listen().<tr><td><a id="l156"></a><a href="#l156">156</a><td> *<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {goog.events.ListenableKey} key The key returned by<tr><td><a id="l158"></a><a href="#l158">158</a><td> * listen() or listenOnce().<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l160"></a><a href="#l160">160</a><td> */<tr><td><a id="l161"></a><a href="#l161">161</a><td>goog.events.Listenable.prototype.unlistenByKey;<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Dispatches an event (or event like object) and calls all listeners<tr><td><a id="l166"></a><a href="#l166">166</a><td> * listening for events of this type. The type of the event is decided by the<tr><td><a id="l167"></a><a href="#l167">167</a><td> * type property on the event object.<tr><td><a id="l168"></a><a href="#l168">168</a><td> *<tr><td><a id="l169"></a><a href="#l169">169</a><td> * If any of the listeners returns false OR calls preventDefault then this<tr><td><a id="l170"></a><a href="#l170">170</a><td> * function will return false. If one of the capture listeners calls<tr><td><a id="l171"></a><a href="#l171">171</a><td> * stopPropagation, then the bubble listeners won&#39;t fire.<tr><td><a id="l172"></a><a href="#l172">172</a><td> *<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {goog.events.EventLike} e Event object.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {boolean} If anyone called preventDefault on the event object (or<tr><td><a id="l175"></a><a href="#l175">175</a><td> * if any of the listeners returns false) this will also return false.<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.events.Listenable.prototype.dispatchEvent;<tr><td><a id="l178"></a><a href="#l178">178</a><td><tr><td><a id="l179"></a><a href="#l179">179</a><td><tr><td><a id="l180"></a><a href="#l180">180</a><td>/**<tr><td><a id="l181"></a><a href="#l181">181</a><td> * Removes all listeners from this listenable. If type is specified,<tr><td><a id="l182"></a><a href="#l182">182</a><td> * it will only remove listeners of the particular type. otherwise all<tr><td><a id="l183"></a><a href="#l183">183</a><td> * registered listeners will be removed.<tr><td><a id="l184"></a><a href="#l184">184</a><td> *<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {string=} opt_type Type of event to remove, default is to<tr><td><a id="l186"></a><a href="#l186">186</a><td> * remove all types.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {number} Number of listeners removed.<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>goog.events.Listenable.prototype.removeAllListeners;<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> * Returns the parent of this event target to use for capture/bubble<tr><td><a id="l194"></a><a href="#l194">194</a><td> * mechanism.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * NOTE(chrishenry): The name reflects the original implementation of<tr><td><a id="l197"></a><a href="#l197">197</a><td> * custom event target ({@code goog.events.EventTarget}). We decided<tr><td><a id="l198"></a><a href="#l198">198</a><td> * that changing the name is not worth it.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {goog.events.Listenable} The parent EventTarget or null if<tr><td><a id="l201"></a><a href="#l201">201</a><td> * there is no parent.<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>goog.events.Listenable.prototype.getParentEventTarget;<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> * Fires all registered listeners in this listenable for the given<tr><td><a id="l208"></a><a href="#l208">208</a><td> * type and capture mode, passing them the given eventObject. This<tr><td><a id="l209"></a><a href="#l209">209</a><td> * does not perform actual capture/bubble. Only implementors of the<tr><td><a id="l210"></a><a href="#l210">210</a><td> * interface should be using this.<tr><td><a id="l211"></a><a href="#l211">211</a><td> *<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The type of the<tr><td><a id="l213"></a><a href="#l213">213</a><td> * listeners to fire.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {boolean} capture The capture mode of the listeners to fire.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {EVENTOBJ} eventObject The event object to fire.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @return {boolean} Whether all listeners succeeded without<tr><td><a id="l217"></a><a href="#l217">217</a><td> * attempting to prevent default behavior. If any listener returns<tr><td><a id="l218"></a><a href="#l218">218</a><td> * false or called goog.events.Event#preventDefault, this returns<tr><td><a id="l219"></a><a href="#l219">219</a><td> * false.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @template EVENTOBJ<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.events.Listenable.prototype.fireListeners;<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>/**<tr><td><a id="l226"></a><a href="#l226">226</a><td> * Gets all listeners in this listenable for the given type and<tr><td><a id="l227"></a><a href="#l227">227</a><td> * capture mode.<tr><td><a id="l228"></a><a href="#l228">228</a><td> *<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @param {string|!goog.events.EventId} type The type of the listeners to fire.<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @param {boolean} capture The capture mode of the listeners to fire.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @return {!Array&lt;goog.events.ListenableKey&gt;} An array of registered<tr><td><a id="l232"></a><a href="#l232">232</a><td> * listeners.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @template EVENTOBJ<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.events.Listenable.prototype.getListeners;<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> * Gets the goog.events.ListenableKey for the event or null if no such<tr><td><a id="l240"></a><a href="#l240">240</a><td> * listener is in use.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The name of the event<tr><td><a id="l243"></a><a href="#l243">243</a><td> * without the &#39;on&#39; prefix.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener The<tr><td><a id="l245"></a><a href="#l245">245</a><td> * listener function to get.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @param {boolean} capture Whether the listener is a capturing listener.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l248"></a><a href="#l248">248</a><td> * listener.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @return {goog.events.ListenableKey} the found listener or null if not found.<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.events.Listenable.prototype.getListener;<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Whether there is any active listeners matching the specified<tr><td><a id="l257"></a><a href="#l257">257</a><td> * signature. If either the type or capture parameters are<tr><td><a id="l258"></a><a href="#l258">258</a><td> * unspecified, the function will match on the remaining criteria.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;=} opt_type Event type.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean=} opt_capture Whether to check for capture or bubble<tr><td><a id="l262"></a><a href="#l262">262</a><td> * listeners.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @return {boolean} Whether there is any active listeners matching<tr><td><a id="l264"></a><a href="#l264">264</a><td> * the requested type and/or capture phase.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @template EVENTOBJ<tr><td><a id="l266"></a><a href="#l266">266</a><td> */<tr><td><a id="l267"></a><a href="#l267">267</a><td>goog.events.Listenable.prototype.hasListener;<tr><td><a id="l268"></a><a href="#l268">268</a><td><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> * An interface that describes a single registered listener.<tr><td><a id="l273"></a><a href="#l273">273</a><td> * @interface<tr><td><a id="l274"></a><a href="#l274">274</a><td> */<tr><td><a id="l275"></a><a href="#l275">275</a><td>goog.events.ListenableKey = function() {};<tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td>/**<tr><td><a id="l279"></a><a href="#l279">279</a><td> * Counter used to create a unique key<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @type {number}<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @private<tr><td><a id="l282"></a><a href="#l282">282</a><td> */<tr><td><a id="l283"></a><a href="#l283">283</a><td>goog.events.ListenableKey.counter_ = 0;<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> * Reserves a key to be used for ListenableKey#key field.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {number} A number to be used to fill ListenableKey#key<tr><td><a id="l289"></a><a href="#l289">289</a><td> * field.<tr><td><a id="l290"></a><a href="#l290">290</a><td> */<tr><td><a id="l291"></a><a href="#l291">291</a><td>goog.events.ListenableKey.reserveKey = function() {<tr><td><a id="l292"></a><a href="#l292">292</a><td> return ++goog.events.ListenableKey.counter_;<tr><td><a id="l293"></a><a href="#l293">293</a><td>};<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>/**<tr><td><a id="l297"></a><a href="#l297">297</a><td> * The source event target.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @type {!(Object|goog.events.Listenable|goog.events.EventTarget)}<tr><td><a id="l299"></a><a href="#l299">299</a><td> */<tr><td><a id="l300"></a><a href="#l300">300</a><td>goog.events.ListenableKey.prototype.src;<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>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * The event type the listener is listening to.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @type {string}<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.events.ListenableKey.prototype.type;<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * The listener function.<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @type {function(?):?|{handleEvent:function(?):?}|null}<tr><td><a id="l313"></a><a href="#l313">313</a><td> */<tr><td><a id="l314"></a><a href="#l314">314</a><td>goog.events.ListenableKey.prototype.listener;<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> * Whether the listener works on capture phase.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @type {boolean}<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>goog.events.ListenableKey.prototype.capture;<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>/**<tr><td><a id="l325"></a><a href="#l325">325</a><td> * The &#39;this&#39; object for the listener function&#39;s scope.<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @type {Object}<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>goog.events.ListenableKey.prototype.handler;<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>/**<tr><td><a id="l332"></a><a href="#l332">332</a><td> * A globally unique number to identify the key.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @type {number}<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>goog.events.ListenableKey.prototype.key;</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>listener.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/goog/events/listener.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Listener object.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see ../demos/events.html<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<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.provide(&#39;goog.events.Listener&#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>goog.require(&#39;goog.events.ListenableKey&#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> * Simple class that stores information about a listener<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {!Function} listener Callback function.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {Function} proxy Wrapper for the listener that patches the event.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {EventTarget|goog.events.Listenable} src Source object for<tr><td><a id="l31"></a><a href="#l31">31</a><td> * the event.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {string} type Event type.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {boolean} capture Whether in capture or bubble phase.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {Object=} opt_handler Object in whose context to execute the callback.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @implements {goog.events.ListenableKey}<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.events.Listener = function(<tr><td><a id="l39"></a><a href="#l39">39</a><td> listener, proxy, src, type, capture, opt_handler) {<tr><td><a id="l40"></a><a href="#l40">40</a><td> if (goog.events.Listener.ENABLE_MONITORING) {<tr><td><a id="l41"></a><a href="#l41">41</a><td> this.creationStack = new Error().stack;<tr><td><a id="l42"></a><a href="#l42">42</a><td> }<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td> /**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Callback function.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @type {Function}<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td> this.listener = listener;<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> * A wrapper over the original listener. This is used solely to<tr><td><a id="l52"></a><a href="#l52">52</a><td> * handle native browser events (it is used to simulate the capture<tr><td><a id="l53"></a><a href="#l53">53</a><td> * phase and to patch the event object).<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @type {Function}<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td> this.proxy = proxy;<tr><td><a id="l57"></a><a href="#l57">57</a><td><tr><td><a id="l58"></a><a href="#l58">58</a><td> /**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Object or node that callback is listening to<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @type {EventTarget|goog.events.Listenable}<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td> this.src = src;<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> * The event type.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @const {string}<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td> this.type = type;<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> * Whether the listener is being called in the capture or bubble phase<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @const {boolean}<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td> this.capture = !!capture;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td> /**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Optional object whose context to execute the listener in<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @type {Object|undefined}<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td> this.handler = opt_handler;<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> * The key of the listener.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @const {number}<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @override<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td> this.key = goog.events.ListenableKey.reserveKey();<tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td> /**<tr><td><a id="l90"></a><a href="#l90">90</a><td> * Whether to remove the listener after it has been called.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @type {boolean}<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td> this.callOnce = false;<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> * Whether the listener has been removed.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @type {boolean}<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td> this.removed = false;<tr><td><a id="l100"></a><a href="#l100">100</a><td>};<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @define {boolean} Whether to enable the monitoring of the<tr><td><a id="l105"></a><a href="#l105">105</a><td> * goog.events.Listener instances. Switching on the monitoring is only<tr><td><a id="l106"></a><a href="#l106">106</a><td> * recommended for debugging because it has a significant impact on<tr><td><a id="l107"></a><a href="#l107">107</a><td> * performance and memory usage. If switched off, the monitoring code<tr><td><a id="l108"></a><a href="#l108">108</a><td> * compiles down to 0 bytes.<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.define(&#39;goog.events.Listener.ENABLE_MONITORING&#39;, false);<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> * If monitoring the goog.events.Listener instances is enabled, stores the<tr><td><a id="l115"></a><a href="#l115">115</a><td> * creation stack trace of the Disposable instance.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @type {string}<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.events.Listener.prototype.creationStack;<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> * Marks this listener as removed. This also remove references held by<tr><td><a id="l123"></a><a href="#l123">123</a><td> * this listener object (such as listener and event source).<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.events.Listener.prototype.markAsRemoved = function() {<tr><td><a id="l126"></a><a href="#l126">126</a><td> this.removed = true;<tr><td><a id="l127"></a><a href="#l127">127</a><td> this.listener = null;<tr><td><a id="l128"></a><a href="#l128">128</a><td> this.proxy = null;<tr><td><a id="l129"></a><a href="#l129">129</a><td> this.src = null;<tr><td><a id="l130"></a><a href="#l130">130</a><td> this.handler = null;<tr><td><a id="l131"></a><a href="#l131">131</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>listenermap.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/goog/events/listenermap.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A map of listeners that provides utility functions to<tr><td><a id="l17"></a><a href="#l17">17</a><td> * deal with listeners on an event target. Used by<tr><td><a id="l18"></a><a href="#l18">18</a><td> * {@code goog.events.EventTarget}.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * WARNING: Do not use this class from outside goog.events package.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @visibility {//closure/goog/bin/sizetests:__pkg__}<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @visibility {//closure/goog/events:__pkg__}<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @visibility {//closure/goog/labs/events:__pkg__}<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>goog.provide(&#39;goog.events.ListenerMap&#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.events.Listener&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Creates a new listener map.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {EventTarget|goog.events.Listenable} src The src object.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @constructor<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @final<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.events.ListenerMap = function(src) {<tr><td><a id="l42"></a><a href="#l42">42</a><td> /** @type {EventTarget|goog.events.Listenable} */<tr><td><a id="l43"></a><a href="#l43">43</a><td> this.src = src;<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td> /**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Maps of event type to an array of listeners.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @type {Object&lt;string, !Array&lt;!goog.events.Listener&gt;&gt;}<tr><td><a id="l48"></a><a href="#l48">48</a><td> */<tr><td><a id="l49"></a><a href="#l49">49</a><td> this.listeners = {};<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> * The count of types in this map that have registered listeners.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @private {number}<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td> this.typeCount_ = 0;<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><tr><td><a id="l59"></a><a href="#l59">59</a><td>/**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @return {number} The count of event types in this map that actually<tr><td><a id="l61"></a><a href="#l61">61</a><td> * have registered listeners.<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.events.ListenerMap.prototype.getTypeCount = function() {<tr><td><a id="l64"></a><a href="#l64">64</a><td> return this.typeCount_;<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>/**<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @return {number} Total number of registered listeners.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.events.ListenerMap.prototype.getListenerCount = function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td> var count = 0;<tr><td><a id="l73"></a><a href="#l73">73</a><td> for (var type in this.listeners) {<tr><td><a id="l74"></a><a href="#l74">74</a><td> count += this.listeners[type].length;<tr><td><a id="l75"></a><a href="#l75">75</a><td> }<tr><td><a id="l76"></a><a href="#l76">76</a><td> return count;<tr><td><a id="l77"></a><a href="#l77">77</a><td>};<tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td>/**<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Adds an event listener. A listener can only be added once to an<tr><td><a id="l82"></a><a href="#l82">82</a><td> * object and if it is added again the key for the listener is<tr><td><a id="l83"></a><a href="#l83">83</a><td> * returned.<tr><td><a id="l84"></a><a href="#l84">84</a><td> *<tr><td><a id="l85"></a><a href="#l85">85</a><td> * Note that a one-off listener will not change an existing listener,<tr><td><a id="l86"></a><a href="#l86">86</a><td> * if any. On the other hand a normal listener will change existing<tr><td><a id="l87"></a><a href="#l87">87</a><td> * one-off listener to become a normal listener.<tr><td><a id="l88"></a><a href="#l88">88</a><td> *<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {string|!goog.events.EventId} type The listener event type.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @param {!Function} listener This listener callback method.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @param {boolean} callOnce Whether the listener is a one-off<tr><td><a id="l92"></a><a href="#l92">92</a><td> * listener.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {boolean=} opt_useCapture The capture mode of the listener.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l95"></a><a href="#l95">95</a><td> * listener.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.events.ListenerMap.prototype.add = function(<tr><td><a id="l99"></a><a href="#l99">99</a><td> type, listener, callOnce, opt_useCapture, opt_listenerScope) {<tr><td><a id="l100"></a><a href="#l100">100</a><td> var typeStr = type.toString();<tr><td><a id="l101"></a><a href="#l101">101</a><td> var listenerArray = this.listeners[typeStr];<tr><td><a id="l102"></a><a href="#l102">102</a><td> if (!listenerArray) {<tr><td><a id="l103"></a><a href="#l103">103</a><td> listenerArray = this.listeners[typeStr] = [];<tr><td><a id="l104"></a><a href="#l104">104</a><td> this.typeCount_++;<tr><td><a id="l105"></a><a href="#l105">105</a><td> }<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td> var listenerObj;<tr><td><a id="l108"></a><a href="#l108">108</a><td> var index = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l109"></a><a href="#l109">109</a><td> listenerArray, listener, opt_useCapture, opt_listenerScope);<tr><td><a id="l110"></a><a href="#l110">110</a><td> if (index &gt; -1) {<tr><td><a id="l111"></a><a href="#l111">111</a><td> listenerObj = listenerArray[index];<tr><td><a id="l112"></a><a href="#l112">112</a><td> if (!callOnce) {<tr><td><a id="l113"></a><a href="#l113">113</a><td> // Ensure that, if there is an existing callOnce listener, it is no<tr><td><a id="l114"></a><a href="#l114">114</a><td> // longer a callOnce listener.<tr><td><a id="l115"></a><a href="#l115">115</a><td> listenerObj.callOnce = false;<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td> } else {<tr><td><a id="l118"></a><a href="#l118">118</a><td> listenerObj = new goog.events.Listener(<tr><td><a id="l119"></a><a href="#l119">119</a><td> listener, null, this.src, typeStr, !!opt_useCapture, opt_listenerScope);<tr><td><a id="l120"></a><a href="#l120">120</a><td> listenerObj.callOnce = callOnce;<tr><td><a id="l121"></a><a href="#l121">121</a><td> listenerArray.push(listenerObj);<tr><td><a id="l122"></a><a href="#l122">122</a><td> }<tr><td><a id="l123"></a><a href="#l123">123</a><td> return listenerObj;<tr><td><a id="l124"></a><a href="#l124">124</a><td>};<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>/**<tr><td><a id="l128"></a><a href="#l128">128</a><td> * Removes a matching listener.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {string|!goog.events.EventId} type The listener event type.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {!Function} listener This listener callback method.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {boolean=} opt_useCapture The capture mode of the listener.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l133"></a><a href="#l133">133</a><td> * listener.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.events.ListenerMap.prototype.remove = function(<tr><td><a id="l137"></a><a href="#l137">137</a><td> type, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l138"></a><a href="#l138">138</a><td> var typeStr = type.toString();<tr><td><a id="l139"></a><a href="#l139">139</a><td> if (!(typeStr in this.listeners)) {<tr><td><a id="l140"></a><a href="#l140">140</a><td> return false;<tr><td><a id="l141"></a><a href="#l141">141</a><td> }<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td> var listenerArray = this.listeners[typeStr];<tr><td><a id="l144"></a><a href="#l144">144</a><td> var index = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l145"></a><a href="#l145">145</a><td> listenerArray, listener, opt_useCapture, opt_listenerScope);<tr><td><a id="l146"></a><a href="#l146">146</a><td> if (index &gt; -1) {<tr><td><a id="l147"></a><a href="#l147">147</a><td> var listenerObj = listenerArray[index];<tr><td><a id="l148"></a><a href="#l148">148</a><td> listenerObj.markAsRemoved();<tr><td><a id="l149"></a><a href="#l149">149</a><td> goog.array.removeAt(listenerArray, index);<tr><td><a id="l150"></a><a href="#l150">150</a><td> if (listenerArray.length == 0) {<tr><td><a id="l151"></a><a href="#l151">151</a><td> delete this.listeners[typeStr];<tr><td><a id="l152"></a><a href="#l152">152</a><td> this.typeCount_--;<tr><td><a id="l153"></a><a href="#l153">153</a><td> }<tr><td><a id="l154"></a><a href="#l154">154</a><td> return true;<tr><td><a id="l155"></a><a href="#l155">155</a><td> }<tr><td><a id="l156"></a><a href="#l156">156</a><td> return false;<tr><td><a id="l157"></a><a href="#l157">157</a><td>};<tr><td><a id="l158"></a><a href="#l158">158</a><td><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> * Removes the given listener object.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {goog.events.ListenableKey} listener The listener to remove.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @return {boolean} Whether the listener is removed.<tr><td><a id="l164"></a><a href="#l164">164</a><td> */<tr><td><a id="l165"></a><a href="#l165">165</a><td>goog.events.ListenerMap.prototype.removeByKey = function(listener) {<tr><td><a id="l166"></a><a href="#l166">166</a><td> var type = listener.type;<tr><td><a id="l167"></a><a href="#l167">167</a><td> if (!(type in this.listeners)) {<tr><td><a id="l168"></a><a href="#l168">168</a><td> return false;<tr><td><a id="l169"></a><a href="#l169">169</a><td> }<tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td> var removed = goog.array.remove(this.listeners[type], listener);<tr><td><a id="l172"></a><a href="#l172">172</a><td> if (removed) {<tr><td><a id="l173"></a><a href="#l173">173</a><td> listener.markAsRemoved();<tr><td><a id="l174"></a><a href="#l174">174</a><td> if (this.listeners[type].length == 0) {<tr><td><a id="l175"></a><a href="#l175">175</a><td> delete this.listeners[type];<tr><td><a id="l176"></a><a href="#l176">176</a><td> this.typeCount_--;<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 removed;<tr><td><a id="l180"></a><a href="#l180">180</a><td>};<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Removes all listeners from this map. If opt_type is provided, only<tr><td><a id="l185"></a><a href="#l185">185</a><td> * listeners that match the given type are removed.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {string|!goog.events.EventId=} opt_type Type of event to remove.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {number} Number of listeners removed.<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>goog.events.ListenerMap.prototype.removeAll = function(opt_type) {<tr><td><a id="l190"></a><a href="#l190">190</a><td> var typeStr = opt_type &amp;&amp; opt_type.toString();<tr><td><a id="l191"></a><a href="#l191">191</a><td> var count = 0;<tr><td><a id="l192"></a><a href="#l192">192</a><td> for (var type in this.listeners) {<tr><td><a id="l193"></a><a href="#l193">193</a><td> if (!typeStr || type == typeStr) {<tr><td><a id="l194"></a><a href="#l194">194</a><td> var listenerArray = this.listeners[type];<tr><td><a id="l195"></a><a href="#l195">195</a><td> for (var i = 0; i &lt; listenerArray.length; i++) {<tr><td><a id="l196"></a><a href="#l196">196</a><td> ++count;<tr><td><a id="l197"></a><a href="#l197">197</a><td> listenerArray[i].markAsRemoved();<tr><td><a id="l198"></a><a href="#l198">198</a><td> }<tr><td><a id="l199"></a><a href="#l199">199</a><td> delete this.listeners[type];<tr><td><a id="l200"></a><a href="#l200">200</a><td> this.typeCount_--;<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> return count;<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>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Gets all listeners that match the given type and capture mode. The<tr><td><a id="l209"></a><a href="#l209">209</a><td> * returned array is a copy (but the listener objects are not).<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string|!goog.events.EventId} type The type of the listeners<tr><td><a id="l211"></a><a href="#l211">211</a><td> * to retrieve.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {boolean} capture The capture mode of the listeners to retrieve.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @return {!Array&lt;goog.events.ListenableKey&gt;} An array of matching<tr><td><a id="l214"></a><a href="#l214">214</a><td> * listeners.<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>goog.events.ListenerMap.prototype.getListeners = function(type, capture) {<tr><td><a id="l217"></a><a href="#l217">217</a><td> var listenerArray = this.listeners[type.toString()];<tr><td><a id="l218"></a><a href="#l218">218</a><td> var rv = [];<tr><td><a id="l219"></a><a href="#l219">219</a><td> if (listenerArray) {<tr><td><a id="l220"></a><a href="#l220">220</a><td> for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l221"></a><a href="#l221">221</a><td> var listenerObj = listenerArray[i];<tr><td><a id="l222"></a><a href="#l222">222</a><td> if (listenerObj.capture == capture) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> rv.push(listenerObj);<tr><td><a id="l224"></a><a href="#l224">224</a><td> }<tr><td><a id="l225"></a><a href="#l225">225</a><td> }<tr><td><a id="l226"></a><a href="#l226">226</a><td> }<tr><td><a id="l227"></a><a href="#l227">227</a><td> return rv;<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>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Gets the goog.events.ListenableKey for the event or null if no such<tr><td><a id="l233"></a><a href="#l233">233</a><td> * listener is in use.<tr><td><a id="l234"></a><a href="#l234">234</a><td> *<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {string|!goog.events.EventId} type The type of the listener<tr><td><a id="l236"></a><a href="#l236">236</a><td> * to retrieve.<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @param {!Function} listener The listener function to get.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @param {boolean} capture Whether the listener is a capturing listener.<tr><td><a id="l239"></a><a href="#l239">239</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l240"></a><a href="#l240">240</a><td> * listener.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @return {goog.events.ListenableKey} the found listener or null if not found.<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.events.ListenerMap.prototype.getListener = function(<tr><td><a id="l244"></a><a href="#l244">244</a><td> type, listener, capture, opt_listenerScope) {<tr><td><a id="l245"></a><a href="#l245">245</a><td> var listenerArray = this.listeners[type.toString()];<tr><td><a id="l246"></a><a href="#l246">246</a><td> var i = -1;<tr><td><a id="l247"></a><a href="#l247">247</a><td> if (listenerArray) {<tr><td><a id="l248"></a><a href="#l248">248</a><td> i = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l249"></a><a href="#l249">249</a><td> listenerArray, listener, capture, opt_listenerScope);<tr><td><a id="l250"></a><a href="#l250">250</a><td> }<tr><td><a id="l251"></a><a href="#l251">251</a><td> return i &gt; -1 ? listenerArray[i] : null;<tr><td><a id="l252"></a><a href="#l252">252</a><td>};<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Whether there is a matching listener. If either the type or capture<tr><td><a id="l257"></a><a href="#l257">257</a><td> * parameters are unspecified, the function will match on the<tr><td><a id="l258"></a><a href="#l258">258</a><td> * remaining criteria.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {string|!goog.events.EventId=} opt_type The type of the listener.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean=} opt_capture The capture mode of the listener.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {boolean} Whether there is an active listener matching<tr><td><a id="l263"></a><a href="#l263">263</a><td> * the requested type and/or capture phase.<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td>goog.events.ListenerMap.prototype.hasListener = function(<tr><td><a id="l266"></a><a href="#l266">266</a><td> opt_type, opt_capture) {<tr><td><a id="l267"></a><a href="#l267">267</a><td> var hasType = goog.isDef(opt_type);<tr><td><a id="l268"></a><a href="#l268">268</a><td> var typeStr = hasType ? opt_type.toString() : &#39;&#39;;<tr><td><a id="l269"></a><a href="#l269">269</a><td> var hasCapture = goog.isDef(opt_capture);<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td> return goog.object.some(<tr><td><a id="l272"></a><a href="#l272">272</a><td> this.listeners, function(listenerArray, type) {<tr><td><a id="l273"></a><a href="#l273">273</a><td> for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l274"></a><a href="#l274">274</a><td> if ((!hasType || listenerArray[i].type == typeStr) &amp;&amp;<tr><td><a id="l275"></a><a href="#l275">275</a><td> (!hasCapture || listenerArray[i].capture == opt_capture)) {<tr><td><a id="l276"></a><a href="#l276">276</a><td> return true;<tr><td><a id="l277"></a><a href="#l277">277</a><td> }<tr><td><a id="l278"></a><a href="#l278">278</a><td> }<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td> return false;<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><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Finds the index of a matching goog.events.Listener in the given<tr><td><a id="l287"></a><a href="#l287">287</a><td> * listenerArray.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @param {!Array&lt;!goog.events.Listener&gt;} listenerArray Array of listener.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @param {!Function} listener The listener function.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {boolean=} opt_useCapture The capture flag for the listener.<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @param {Object=} opt_listenerScope The listener scope.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {number} The index of the matching listener within the<tr><td><a id="l293"></a><a href="#l293">293</a><td> * listenerArray.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @private<tr><td><a id="l295"></a><a href="#l295">295</a><td> */<tr><td><a id="l296"></a><a href="#l296">296</a><td>goog.events.ListenerMap.findListenerIndex_ = function(<tr><td><a id="l297"></a><a href="#l297">297</a><td> listenerArray, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l298"></a><a href="#l298">298</a><td> for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l299"></a><a href="#l299">299</a><td> var listenerObj = listenerArray[i];<tr><td><a id="l300"></a><a href="#l300">300</a><td> if (!listenerObj.removed &amp;&amp;<tr><td><a id="l301"></a><a href="#l301">301</a><td> listenerObj.listener == listener &amp;&amp;<tr><td><a id="l302"></a><a href="#l302">302</a><td> listenerObj.capture == !!opt_useCapture &amp;&amp;<tr><td><a id="l303"></a><a href="#l303">303</a><td> listenerObj.handler == opt_listenerScope) {<tr><td><a id="l304"></a><a href="#l304">304</a><td> return i;<tr><td><a id="l305"></a><a href="#l305">305</a><td> }<tr><td><a id="l306"></a><a href="#l306">306</a><td> }<tr><td><a id="l307"></a><a href="#l307">307</a><td> return -1;<tr><td><a id="l308"></a><a href="#l308">308</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>