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>nodetype.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/dom/nodetype.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 Definition of goog.dom.NodeType.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.provide(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>/**<tr><td><a id="l23"></a><a href="#l23">23</a><td> * Constants for the nodeType attribute in the Node interface.<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * These constants match those specified in the Node interface. These are<tr><td><a id="l26"></a><a href="#l26">26</a><td> * usually present on the Node object in recent browsers, but not in older<tr><td><a id="l27"></a><a href="#l27">27</a><td> * browsers (specifically, early IEs) and thus are given here.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * In some browsers (early IEs), these are not defined on the Node object,<tr><td><a id="l30"></a><a href="#l30">30</a><td> * so they are provided here.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * See http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1950641247<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.dom.NodeType = {<tr><td><a id="l36"></a><a href="#l36">36</a><td> ELEMENT: 1,<tr><td><a id="l37"></a><a href="#l37">37</a><td> ATTRIBUTE: 2,<tr><td><a id="l38"></a><a href="#l38">38</a><td> TEXT: 3,<tr><td><a id="l39"></a><a href="#l39">39</a><td> CDATA_SECTION: 4,<tr><td><a id="l40"></a><a href="#l40">40</a><td> ENTITY_REFERENCE: 5,<tr><td><a id="l41"></a><a href="#l41">41</a><td> ENTITY: 6,<tr><td><a id="l42"></a><a href="#l42">42</a><td> PROCESSING_INSTRUCTION: 7,<tr><td><a id="l43"></a><a href="#l43">43</a><td> COMMENT: 8,<tr><td><a id="l44"></a><a href="#l44">44</a><td> DOCUMENT: 9,<tr><td><a id="l45"></a><a href="#l45">45</a><td> DOCUMENT_TYPE: 10,<tr><td><a id="l46"></a><a href="#l46">46</a><td> DOCUMENT_FRAGMENT: 11,<tr><td><a id="l47"></a><a href="#l47">47</a><td> NOTATION: 12<tr><td><a id="l48"></a><a href="#l48">48</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>safe.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/dom/safe.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 Type-safe wrappers for unsafe DOM APIs.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * This file provides type-safe wrappers for DOM APIs that can result in<tr><td><a id="l19"></a><a href="#l19">19</a><td> * cross-site scripting (XSS) vulnerabilities, if the API is supplied with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * untrusted (attacker-controlled) input. Instead of plain strings, the type<tr><td><a id="l21"></a><a href="#l21">21</a><td> * safe wrappers consume values of types from the goog.html package whose<tr><td><a id="l22"></a><a href="#l22">22</a><td> * contract promises that values are safe to use in the corresponding context.<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * Hence, a program that exclusively uses the wrappers in this file (i.e., whose<tr><td><a id="l25"></a><a href="#l25">25</a><td> * only reference to security-sensitive raw DOM APIs are in this file) is<tr><td><a id="l26"></a><a href="#l26">26</a><td> * guaranteed to be free of XSS due to incorrect use of such DOM APIs (modulo<tr><td><a id="l27"></a><a href="#l27">27</a><td> * correctness of code that produces values of the respective goog.html types,<tr><td><a id="l28"></a><a href="#l28">28</a><td> * and absent code that violates type safety).<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * For example, assigning to an element&#39;s .innerHTML property a string that is<tr><td><a id="l31"></a><a href="#l31">31</a><td> * derived (even partially) from untrusted input typically results in an XSS<tr><td><a id="l32"></a><a href="#l32">32</a><td> * vulnerability. The type-safe wrapper goog.html.setInnerHtml consumes a value<tr><td><a id="l33"></a><a href="#l33">33</a><td> * of type goog.html.SafeHtml, whose contract states that using its values in a<tr><td><a id="l34"></a><a href="#l34">34</a><td> * HTML context will not result in XSS. Hence a program that is free of direct<tr><td><a id="l35"></a><a href="#l35">35</a><td> * assignments to any element&#39;s innerHTML property (with the exception of the<tr><td><a id="l36"></a><a href="#l36">36</a><td> * assignment to .innerHTML in this file) is guaranteed to be free of XSS due to<tr><td><a id="l37"></a><a href="#l37">37</a><td> * assignment of untrusted strings to the innerHTML property.<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>goog.provide(&#39;goog.dom.safe&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.provide(&#39;goog.dom.safe.InsertAdjacentHtmlPosition&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.string.Const&#39;);<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>/** @enum {string} */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.dom.safe.InsertAdjacentHtmlPosition = {<tr><td><a id="l53"></a><a href="#l53">53</a><td> AFTERBEGIN: &#39;afterbegin&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td> AFTEREND: &#39;afterend&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td> BEFOREBEGIN: &#39;beforebegin&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td> BEFOREEND: &#39;beforeend&#39;<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td>/**<tr><td><a id="l61"></a><a href="#l61">61</a><td> * Inserts known-safe HTML into a Node, at the specified position.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {!Node} node The node on which to call insertAdjacentHTML.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {!goog.dom.safe.InsertAdjacentHtmlPosition} position Position where<tr><td><a id="l64"></a><a href="#l64">64</a><td> * to insert the HTML.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to insert.<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.dom.safe.insertAdjacentHtml = function(node, position, html) {<tr><td><a id="l68"></a><a href="#l68">68</a><td> node.insertAdjacentHTML(position, goog.html.SafeHtml.unwrap(html));<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>/**<tr><td><a id="l73"></a><a href="#l73">73</a><td> * Assigns known-safe HTML to an element&#39;s innerHTML property.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {!Element} elem The element whose innerHTML is to be assigned to.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td>goog.dom.safe.setInnerHtml = function(elem, html) {<tr><td><a id="l78"></a><a href="#l78">78</a><td> elem.innerHTML = goog.html.SafeHtml.unwrap(html);<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Assigns known-safe HTML to an element&#39;s outerHTML property.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {!Element} elem The element whose outerHTML is to be assigned to.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>goog.dom.safe.setOuterHtml = function(elem, html) {<tr><td><a id="l88"></a><a href="#l88">88</a><td> elem.outerHTML = goog.html.SafeHtml.unwrap(html);<tr><td><a id="l89"></a><a href="#l89">89</a><td>};<tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td>/**<tr><td><a id="l93"></a><a href="#l93">93</a><td> * Writes known-safe HTML to a document.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {!Document} doc The document to be written to.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<tr><td><a id="l96"></a><a href="#l96">96</a><td> */<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.dom.safe.documentWrite = function(doc, html) {<tr><td><a id="l98"></a><a href="#l98">98</a><td> doc.write(goog.html.SafeHtml.unwrap(html));<tr><td><a id="l99"></a><a href="#l99">99</a><td>};<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td>/**<tr><td><a id="l103"></a><a href="#l103">103</a><td> * Safely assigns a URL to an anchor element&#39;s href property.<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to<tr><td><a id="l106"></a><a href="#l106">106</a><td> * anchor&#39;s href property. If url is of type string however, it is first<tr><td><a id="l107"></a><a href="#l107">107</a><td> * sanitized using goog.html.SafeUrl.sanitize.<tr><td><a id="l108"></a><a href="#l108">108</a><td> *<tr><td><a id="l109"></a><a href="#l109">109</a><td> * Example usage:<tr><td><a id="l110"></a><a href="#l110">110</a><td> * goog.dom.safe.setAnchorHref(anchorEl, url);<tr><td><a id="l111"></a><a href="#l111">111</a><td> * which is a safe alternative to<tr><td><a id="l112"></a><a href="#l112">112</a><td> * anchorEl.href = url;<tr><td><a id="l113"></a><a href="#l113">113</a><td> * The latter can result in XSS vulnerabilities if url is a<tr><td><a id="l114"></a><a href="#l114">114</a><td> * user-/attacker-controlled value.<tr><td><a id="l115"></a><a href="#l115">115</a><td> *<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {!HTMLAnchorElement} anchor The anchor element whose href property<tr><td><a id="l117"></a><a href="#l117">117</a><td> * is to be assigned to.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @param {string|!goog.html.SafeUrl} url The URL to assign.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td>goog.dom.safe.setAnchorHref = function(anchor, url) {<tr><td><a id="l122"></a><a href="#l122">122</a><td> /** @type {!goog.html.SafeUrl} */<tr><td><a id="l123"></a><a href="#l123">123</a><td> var safeUrl;<tr><td><a id="l124"></a><a href="#l124">124</a><td> if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l125"></a><a href="#l125">125</a><td> safeUrl = url;<tr><td><a id="l126"></a><a href="#l126">126</a><td> } else {<tr><td><a id="l127"></a><a href="#l127">127</a><td> safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l128"></a><a href="#l128">128</a><td> }<tr><td><a id="l129"></a><a href="#l129">129</a><td> anchor.href = goog.html.SafeUrl.unwrap(safeUrl);<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Safely assigns a URL to an embed element&#39;s src property.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Example usage:<tr><td><a id="l137"></a><a href="#l137">137</a><td> * goog.dom.safe.setEmbedSrc(embedEl, url);<tr><td><a id="l138"></a><a href="#l138">138</a><td> * which is a safe alternative to<tr><td><a id="l139"></a><a href="#l139">139</a><td> * embedEl.src = url;<tr><td><a id="l140"></a><a href="#l140">140</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l141"></a><a href="#l141">141</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l142"></a><a href="#l142">142</a><td> *<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {!HTMLEmbedElement} embed The embed element whose src property<tr><td><a id="l144"></a><a href="#l144">144</a><td> * is to be assigned to.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.dom.safe.setEmbedSrc = function(embed, url) {<tr><td><a id="l148"></a><a href="#l148">148</a><td> embed.src = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><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> * Safely assigns a URL to a frame element&#39;s src property.<tr><td><a id="l154"></a><a href="#l154">154</a><td> *<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Example usage:<tr><td><a id="l156"></a><a href="#l156">156</a><td> * goog.dom.safe.setFrameSrc(frameEl, url);<tr><td><a id="l157"></a><a href="#l157">157</a><td> * which is a safe alternative to<tr><td><a id="l158"></a><a href="#l158">158</a><td> * frameEl.src = url;<tr><td><a id="l159"></a><a href="#l159">159</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l160"></a><a href="#l160">160</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l161"></a><a href="#l161">161</a><td> *<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {!HTMLFrameElement} frame The frame element whose src property<tr><td><a id="l163"></a><a href="#l163">163</a><td> * is to be assigned to.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.dom.safe.setFrameSrc = function(frame, url) {<tr><td><a id="l167"></a><a href="#l167">167</a><td> frame.src = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l168"></a><a href="#l168">168</a><td>};<tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td>/**<tr><td><a id="l172"></a><a href="#l172">172</a><td> * Safely assigns a URL to an iframe element&#39;s src property.<tr><td><a id="l173"></a><a href="#l173">173</a><td> *<tr><td><a id="l174"></a><a href="#l174">174</a><td> * Example usage:<tr><td><a id="l175"></a><a href="#l175">175</a><td> * goog.dom.safe.setIframeSrc(iframeEl, url);<tr><td><a id="l176"></a><a href="#l176">176</a><td> * which is a safe alternative to<tr><td><a id="l177"></a><a href="#l177">177</a><td> * iframeEl.src = url;<tr><td><a id="l178"></a><a href="#l178">178</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l179"></a><a href="#l179">179</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l180"></a><a href="#l180">180</a><td> *<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {!HTMLIFrameElement} iframe The iframe element whose src property<tr><td><a id="l182"></a><a href="#l182">182</a><td> * is to be assigned to.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>goog.dom.safe.setIframeSrc = function(iframe, url) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> iframe.src = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l187"></a><a href="#l187">187</a><td>};<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * Safely sets a link element&#39;s href and rel properties. Whether or not<tr><td><a id="l192"></a><a href="#l192">192</a><td> * the URL assigned to href has to be a goog.html.TrustedResourceUrl<tr><td><a id="l193"></a><a href="#l193">193</a><td> * depends on the value of the rel property. If rel contains &quot;stylesheet&quot;<tr><td><a id="l194"></a><a href="#l194">194</a><td> * then a TrustedResourceUrl is required.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Example usage:<tr><td><a id="l197"></a><a href="#l197">197</a><td> * goog.dom.safe.setLinkHrefAndRel(linkEl, url, &#39;stylesheet&#39;);<tr><td><a id="l198"></a><a href="#l198">198</a><td> * which is a safe alternative to<tr><td><a id="l199"></a><a href="#l199">199</a><td> * linkEl.rel = &#39;stylesheet&#39;;<tr><td><a id="l200"></a><a href="#l200">200</a><td> * linkEl.href = url;<tr><td><a id="l201"></a><a href="#l201">201</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l202"></a><a href="#l202">202</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {!HTMLLinkElement} link The link element whose href property<tr><td><a id="l205"></a><a href="#l205">205</a><td> * is to be assigned to.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @param {string|!goog.html.SafeUrl|!goog.html.TrustedResourceUrl} url The URL<tr><td><a id="l207"></a><a href="#l207">207</a><td> * to assign to the href property. Must be a TrustedResourceUrl if the<tr><td><a id="l208"></a><a href="#l208">208</a><td> * value assigned to rel contains &quot;stylesheet&quot;. A string value is<tr><td><a id="l209"></a><a href="#l209">209</a><td> * sanitized with goog.html.SafeUrl.sanitize.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string} rel The value to assign to the rel property.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @throws {Error} if rel contains &quot;stylesheet&quot; and url is not a<tr><td><a id="l212"></a><a href="#l212">212</a><td> * TrustedResourceUrl<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>goog.dom.safe.setLinkHrefAndRel = function(link, url, rel) {<tr><td><a id="l216"></a><a href="#l216">216</a><td> link.rel = rel;<tr><td><a id="l217"></a><a href="#l217">217</a><td> if (goog.string.caseInsensitiveContains(rel, &#39;stylesheet&#39;)) {<tr><td><a id="l218"></a><a href="#l218">218</a><td> goog.asserts.assert(<tr><td><a id="l219"></a><a href="#l219">219</a><td> url instanceof goog.html.TrustedResourceUrl,<tr><td><a id="l220"></a><a href="#l220">220</a><td> &#39;URL must be TrustedResourceUrl because &quot;rel&quot; contains &quot;stylesheet&quot;&#39;);<tr><td><a id="l221"></a><a href="#l221">221</a><td> link.href = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l222"></a><a href="#l222">222</a><td> } else if (url instanceof goog.html.TrustedResourceUrl) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> link.href = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l224"></a><a href="#l224">224</a><td> } else if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l225"></a><a href="#l225">225</a><td> link.href = goog.html.SafeUrl.unwrap(url);<tr><td><a id="l226"></a><a href="#l226">226</a><td> } else { // string<tr><td><a id="l227"></a><a href="#l227">227</a><td> // SafeUrl.sanitize must return legitimate SafeUrl when passed a string.<tr><td><a id="l228"></a><a href="#l228">228</a><td> link.href = goog.html.SafeUrl.sanitize(url).getTypedStringValue();<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><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Safely assigns a URL to an object element&#39;s data property.<tr><td><a id="l235"></a><a href="#l235">235</a><td> *<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Example usage:<tr><td><a id="l237"></a><a href="#l237">237</a><td> * goog.dom.safe.setObjectData(objectEl, url);<tr><td><a id="l238"></a><a href="#l238">238</a><td> * which is a safe alternative to<tr><td><a id="l239"></a><a href="#l239">239</a><td> * objectEl.data = url;<tr><td><a id="l240"></a><a href="#l240">240</a><td> * The latter can result in loading untrusted code unless setit is ensured that<tr><td><a id="l241"></a><a href="#l241">241</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {!HTMLObjectElement} object The object element whose data property<tr><td><a id="l244"></a><a href="#l244">244</a><td> * is to be assigned to.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>goog.dom.safe.setObjectData = function(object, url) {<tr><td><a id="l248"></a><a href="#l248">248</a><td> object.data = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l249"></a><a href="#l249">249</a><td>};<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>/**<tr><td><a id="l253"></a><a href="#l253">253</a><td> * Safely assigns a URL to an iframe element&#39;s src property.<tr><td><a id="l254"></a><a href="#l254">254</a><td> *<tr><td><a id="l255"></a><a href="#l255">255</a><td> * Example usage:<tr><td><a id="l256"></a><a href="#l256">256</a><td> * goog.dom.safe.setScriptSrc(scriptEl, url);<tr><td><a id="l257"></a><a href="#l257">257</a><td> * which is a safe alternative to<tr><td><a id="l258"></a><a href="#l258">258</a><td> * scriptEl.src = url;<tr><td><a id="l259"></a><a href="#l259">259</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l260"></a><a href="#l260">260</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l261"></a><a href="#l261">261</a><td> *<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @param {!HTMLScriptElement} script The script element whose src property<tr><td><a id="l263"></a><a href="#l263">263</a><td> * is to be assigned to.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.dom.safe.setScriptSrc = function(script, url) {<tr><td><a id="l267"></a><a href="#l267">267</a><td> script.src = goog.html.TrustedResourceUrl.unwrap(url);<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> * Safely assigns a URL to a Location object&#39;s href property.<tr><td><a id="l273"></a><a href="#l273">273</a><td> *<tr><td><a id="l274"></a><a href="#l274">274</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to<tr><td><a id="l275"></a><a href="#l275">275</a><td> * loc&#39;s href property. If url is of type string however, it is first sanitized<tr><td><a id="l276"></a><a href="#l276">276</a><td> * using goog.html.SafeUrl.sanitize.<tr><td><a id="l277"></a><a href="#l277">277</a><td> *<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Example usage:<tr><td><a id="l279"></a><a href="#l279">279</a><td> * goog.dom.safe.setLocationHref(document.location, redirectUrl);<tr><td><a id="l280"></a><a href="#l280">280</a><td> * which is a safe alternative to<tr><td><a id="l281"></a><a href="#l281">281</a><td> * document.location.href = redirectUrl;<tr><td><a id="l282"></a><a href="#l282">282</a><td> * The latter can result in XSS vulnerabilities if redirectUrl is a<tr><td><a id="l283"></a><a href="#l283">283</a><td> * user-/attacker-controlled value.<tr><td><a id="l284"></a><a href="#l284">284</a><td> *<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {!Location} loc The Location object whose href property is to be<tr><td><a id="l286"></a><a href="#l286">286</a><td> * assigned to.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @param {string|!goog.html.SafeUrl} url The URL to assign.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.dom.safe.setLocationHref = function(loc, url) {<tr><td><a id="l291"></a><a href="#l291">291</a><td> /** @type {!goog.html.SafeUrl} */<tr><td><a id="l292"></a><a href="#l292">292</a><td> var safeUrl;<tr><td><a id="l293"></a><a href="#l293">293</a><td> if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l294"></a><a href="#l294">294</a><td> safeUrl = url;<tr><td><a id="l295"></a><a href="#l295">295</a><td> } else {<tr><td><a id="l296"></a><a href="#l296">296</a><td> safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l297"></a><a href="#l297">297</a><td> }<tr><td><a id="l298"></a><a href="#l298">298</a><td> loc.href = goog.html.SafeUrl.unwrap(safeUrl);<tr><td><a id="l299"></a><a href="#l299">299</a><td>};<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * Safely opens a URL in a new window (via window.open).<tr><td><a id="l304"></a><a href="#l304">304</a><td> *<tr><td><a id="l305"></a><a href="#l305">305</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and passed in to<tr><td><a id="l306"></a><a href="#l306">306</a><td> * window.open. If url is of type string however, it is first sanitized<tr><td><a id="l307"></a><a href="#l307">307</a><td> * using goog.html.SafeUrl.sanitize.<tr><td><a id="l308"></a><a href="#l308">308</a><td> *<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Note that this function does not prevent leakages via the referer that is<tr><td><a id="l310"></a><a href="#l310">310</a><td> * sent by window.open. It is advised to only use this to open 1st party URLs.<tr><td><a id="l311"></a><a href="#l311">311</a><td> *<tr><td><a id="l312"></a><a href="#l312">312</a><td> * Example usage:<tr><td><a id="l313"></a><a href="#l313">313</a><td> * goog.dom.safe.openInWindow(url);<tr><td><a id="l314"></a><a href="#l314">314</a><td> * which is a safe alternative to<tr><td><a id="l315"></a><a href="#l315">315</a><td> * window.open(url);<tr><td><a id="l316"></a><a href="#l316">316</a><td> * The latter can result in XSS vulnerabilities if redirectUrl is a<tr><td><a id="l317"></a><a href="#l317">317</a><td> * user-/attacker-controlled value.<tr><td><a id="l318"></a><a href="#l318">318</a><td> *<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {string|!goog.html.SafeUrl} url The URL to open.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {Window=} opt_openerWin Window of which to call the .open() method.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * Defaults to the global window.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {!goog.string.Const=} opt_name Name of the window to open in. Can be<tr><td><a id="l323"></a><a href="#l323">323</a><td> * _top, etc as allowed by window.open().<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @param {string=} opt_specs Comma-separated list of specifications, same as<tr><td><a id="l325"></a><a href="#l325">325</a><td> * in window.open().<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @param {boolean=} opt_replace Whether to replace the current entry in browser<tr><td><a id="l327"></a><a href="#l327">327</a><td> * history, same as in window.open().<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @return {Window} Window the url was opened in.<tr><td><a id="l329"></a><a href="#l329">329</a><td> */<tr><td><a id="l330"></a><a href="#l330">330</a><td>goog.dom.safe.openInWindow = function(<tr><td><a id="l331"></a><a href="#l331">331</a><td> url, opt_openerWin, opt_name, opt_specs, opt_replace) {<tr><td><a id="l332"></a><a href="#l332">332</a><td> /** @type {!goog.html.SafeUrl} */<tr><td><a id="l333"></a><a href="#l333">333</a><td> var safeUrl;<tr><td><a id="l334"></a><a href="#l334">334</a><td> if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l335"></a><a href="#l335">335</a><td> safeUrl = url;<tr><td><a id="l336"></a><a href="#l336">336</a><td> } else {<tr><td><a id="l337"></a><a href="#l337">337</a><td> safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l338"></a><a href="#l338">338</a><td> }<tr><td><a id="l339"></a><a href="#l339">339</a><td> var win = opt_openerWin || window;<tr><td><a id="l340"></a><a href="#l340">340</a><td> return win.open(goog.html.SafeUrl.unwrap(safeUrl),<tr><td><a id="l341"></a><a href="#l341">341</a><td> // If opt_name is undefined, simply passing that in to open() causes IE to<tr><td><a id="l342"></a><a href="#l342">342</a><td> // reuse the current window instead of opening a new one. Thus we pass &#39;&#39;<tr><td><a id="l343"></a><a href="#l343">343</a><td> // in instead, which according to spec opens a new window. See<tr><td><a id="l344"></a><a href="#l344">344</a><td> // https://html.spec.whatwg.org/multipage/browsers.html#dom-open .<tr><td><a id="l345"></a><a href="#l345">345</a><td> opt_name ? goog.string.Const.unwrap(opt_name) : &#39;&#39;,<tr><td><a id="l346"></a><a href="#l346">346</a><td> opt_specs, opt_replace);<tr><td><a id="l347"></a><a href="#l347">347</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>tagname.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/dom/tagname.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 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 Defines the goog.dom.TagName enum. This enumerates<tr><td><a id="l17"></a><a href="#l17">17</a><td> * all HTML tag names specified in either the the W3C HTML 4.01 index of<tr><td><a id="l18"></a><a href="#l18">18</a><td> * elements or the HTML5 draft specification.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * References:<tr><td><a id="l21"></a><a href="#l21">21</a><td> * http://www.w3.org/TR/html401/index/elements.html<tr><td><a id="l22"></a><a href="#l22">22</a><td> * http://dev.w3.org/html5/spec/section-index.html<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>goog.provide(&#39;goog.dom.TagName&#39;);<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> * Enum of all html tag names specified by the W3C HTML4.01 and HTML5<tr><td><a id="l30"></a><a href="#l30">30</a><td> * specifications.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @enum {string}<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.dom.TagName = {<tr><td><a id="l34"></a><a href="#l34">34</a><td> A: &#39;A&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td> ABBR: &#39;ABBR&#39;,<tr><td><a id="l36"></a><a href="#l36">36</a><td> ACRONYM: &#39;ACRONYM&#39;,<tr><td><a id="l37"></a><a href="#l37">37</a><td> ADDRESS: &#39;ADDRESS&#39;,<tr><td><a id="l38"></a><a href="#l38">38</a><td> APPLET: &#39;APPLET&#39;,<tr><td><a id="l39"></a><a href="#l39">39</a><td> AREA: &#39;AREA&#39;,<tr><td><a id="l40"></a><a href="#l40">40</a><td> ARTICLE: &#39;ARTICLE&#39;,<tr><td><a id="l41"></a><a href="#l41">41</a><td> ASIDE: &#39;ASIDE&#39;,<tr><td><a id="l42"></a><a href="#l42">42</a><td> AUDIO: &#39;AUDIO&#39;,<tr><td><a id="l43"></a><a href="#l43">43</a><td> B: &#39;B&#39;,<tr><td><a id="l44"></a><a href="#l44">44</a><td> BASE: &#39;BASE&#39;,<tr><td><a id="l45"></a><a href="#l45">45</a><td> BASEFONT: &#39;BASEFONT&#39;,<tr><td><a id="l46"></a><a href="#l46">46</a><td> BDI: &#39;BDI&#39;,<tr><td><a id="l47"></a><a href="#l47">47</a><td> BDO: &#39;BDO&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td> BIG: &#39;BIG&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td> BLOCKQUOTE: &#39;BLOCKQUOTE&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td> BODY: &#39;BODY&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td> BR: &#39;BR&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td> BUTTON: &#39;BUTTON&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td> CANVAS: &#39;CANVAS&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td> CAPTION: &#39;CAPTION&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td> CENTER: &#39;CENTER&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td> CITE: &#39;CITE&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td> CODE: &#39;CODE&#39;,<tr><td><a id="l58"></a><a href="#l58">58</a><td> COL: &#39;COL&#39;,<tr><td><a id="l59"></a><a href="#l59">59</a><td> COLGROUP: &#39;COLGROUP&#39;,<tr><td><a id="l60"></a><a href="#l60">60</a><td> COMMAND: &#39;COMMAND&#39;,<tr><td><a id="l61"></a><a href="#l61">61</a><td> DATA: &#39;DATA&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td> DATALIST: &#39;DATALIST&#39;,<tr><td><a id="l63"></a><a href="#l63">63</a><td> DD: &#39;DD&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td> DEL: &#39;DEL&#39;,<tr><td><a id="l65"></a><a href="#l65">65</a><td> DETAILS: &#39;DETAILS&#39;,<tr><td><a id="l66"></a><a href="#l66">66</a><td> DFN: &#39;DFN&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td> DIALOG: &#39;DIALOG&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td> DIR: &#39;DIR&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td> DIV: &#39;DIV&#39;,<tr><td><a id="l70"></a><a href="#l70">70</a><td> DL: &#39;DL&#39;,<tr><td><a id="l71"></a><a href="#l71">71</a><td> DT: &#39;DT&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td> EM: &#39;EM&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td> EMBED: &#39;EMBED&#39;,<tr><td><a id="l74"></a><a href="#l74">74</a><td> FIELDSET: &#39;FIELDSET&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td> FIGCAPTION: &#39;FIGCAPTION&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td> FIGURE: &#39;FIGURE&#39;,<tr><td><a id="l77"></a><a href="#l77">77</a><td> FONT: &#39;FONT&#39;,<tr><td><a id="l78"></a><a href="#l78">78</a><td> FOOTER: &#39;FOOTER&#39;,<tr><td><a id="l79"></a><a href="#l79">79</a><td> FORM: &#39;FORM&#39;,<tr><td><a id="l80"></a><a href="#l80">80</a><td> FRAME: &#39;FRAME&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td> FRAMESET: &#39;FRAMESET&#39;,<tr><td><a id="l82"></a><a href="#l82">82</a><td> H1: &#39;H1&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td> H2: &#39;H2&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td> H3: &#39;H3&#39;,<tr><td><a id="l85"></a><a href="#l85">85</a><td> H4: &#39;H4&#39;,<tr><td><a id="l86"></a><a href="#l86">86</a><td> H5: &#39;H5&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td> H6: &#39;H6&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td> HEAD: &#39;HEAD&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td> HEADER: &#39;HEADER&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td> HGROUP: &#39;HGROUP&#39;,<tr><td><a id="l91"></a><a href="#l91">91</a><td> HR: &#39;HR&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td> HTML: &#39;HTML&#39;,<tr><td><a id="l93"></a><a href="#l93">93</a><td> I: &#39;I&#39;,<tr><td><a id="l94"></a><a href="#l94">94</a><td> IFRAME: &#39;IFRAME&#39;,<tr><td><a id="l95"></a><a href="#l95">95</a><td> IMG: &#39;IMG&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td> INPUT: &#39;INPUT&#39;,<tr><td><a id="l97"></a><a href="#l97">97</a><td> INS: &#39;INS&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td> ISINDEX: &#39;ISINDEX&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td> KBD: &#39;KBD&#39;,<tr><td><a id="l100"></a><a href="#l100">100</a><td> KEYGEN: &#39;KEYGEN&#39;,<tr><td><a id="l101"></a><a href="#l101">101</a><td> LABEL: &#39;LABEL&#39;,<tr><td><a id="l102"></a><a href="#l102">102</a><td> LEGEND: &#39;LEGEND&#39;,<tr><td><a id="l103"></a><a href="#l103">103</a><td> LI: &#39;LI&#39;,<tr><td><a id="l104"></a><a href="#l104">104</a><td> LINK: &#39;LINK&#39;,<tr><td><a id="l105"></a><a href="#l105">105</a><td> MAP: &#39;MAP&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td> MARK: &#39;MARK&#39;,<tr><td><a id="l107"></a><a href="#l107">107</a><td> MATH: &#39;MATH&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td> MENU: &#39;MENU&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td> META: &#39;META&#39;,<tr><td><a id="l110"></a><a href="#l110">110</a><td> METER: &#39;METER&#39;,<tr><td><a id="l111"></a><a href="#l111">111</a><td> NAV: &#39;NAV&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td> NOFRAMES: &#39;NOFRAMES&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td> NOSCRIPT: &#39;NOSCRIPT&#39;,<tr><td><a id="l114"></a><a href="#l114">114</a><td> OBJECT: &#39;OBJECT&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td> OL: &#39;OL&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td> OPTGROUP: &#39;OPTGROUP&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td> OPTION: &#39;OPTION&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td> OUTPUT: &#39;OUTPUT&#39;,<tr><td><a id="l119"></a><a href="#l119">119</a><td> P: &#39;P&#39;,<tr><td><a id="l120"></a><a href="#l120">120</a><td> PARAM: &#39;PARAM&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td> PRE: &#39;PRE&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td> PROGRESS: &#39;PROGRESS&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td> Q: &#39;Q&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td> RP: &#39;RP&#39;,<tr><td><a id="l125"></a><a href="#l125">125</a><td> RT: &#39;RT&#39;,<tr><td><a id="l126"></a><a href="#l126">126</a><td> RUBY: &#39;RUBY&#39;,<tr><td><a id="l127"></a><a href="#l127">127</a><td> S: &#39;S&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td> SAMP: &#39;SAMP&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td> SCRIPT: &#39;SCRIPT&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td> SECTION: &#39;SECTION&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td> SELECT: &#39;SELECT&#39;,<tr><td><a id="l132"></a><a href="#l132">132</a><td> SMALL: &#39;SMALL&#39;,<tr><td><a id="l133"></a><a href="#l133">133</a><td> SOURCE: &#39;SOURCE&#39;,<tr><td><a id="l134"></a><a href="#l134">134</a><td> SPAN: &#39;SPAN&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td> STRIKE: &#39;STRIKE&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td> STRONG: &#39;STRONG&#39;,<tr><td><a id="l137"></a><a href="#l137">137</a><td> STYLE: &#39;STYLE&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td> SUB: &#39;SUB&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td> SUMMARY: &#39;SUMMARY&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td> SUP: &#39;SUP&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td> SVG: &#39;SVG&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td> TABLE: &#39;TABLE&#39;,<tr><td><a id="l143"></a><a href="#l143">143</a><td> TBODY: &#39;TBODY&#39;,<tr><td><a id="l144"></a><a href="#l144">144</a><td> TD: &#39;TD&#39;,<tr><td><a id="l145"></a><a href="#l145">145</a><td> TEMPLATE: &#39;TEMPLATE&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td> TEXTAREA: &#39;TEXTAREA&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td> TFOOT: &#39;TFOOT&#39;,<tr><td><a id="l148"></a><a href="#l148">148</a><td> TH: &#39;TH&#39;,<tr><td><a id="l149"></a><a href="#l149">149</a><td> THEAD: &#39;THEAD&#39;,<tr><td><a id="l150"></a><a href="#l150">150</a><td> TIME: &#39;TIME&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td> TITLE: &#39;TITLE&#39;,<tr><td><a id="l152"></a><a href="#l152">152</a><td> TR: &#39;TR&#39;,<tr><td><a id="l153"></a><a href="#l153">153</a><td> TRACK: &#39;TRACK&#39;,<tr><td><a id="l154"></a><a href="#l154">154</a><td> TT: &#39;TT&#39;,<tr><td><a id="l155"></a><a href="#l155">155</a><td> U: &#39;U&#39;,<tr><td><a id="l156"></a><a href="#l156">156</a><td> UL: &#39;UL&#39;,<tr><td><a id="l157"></a><a href="#l157">157</a><td> VAR: &#39;VAR&#39;,<tr><td><a id="l158"></a><a href="#l158">158</a><td> VIDEO: &#39;VIDEO&#39;,<tr><td><a id="l159"></a><a href="#l159">159</a><td> WBR: &#39;WBR&#39;<tr><td><a id="l160"></a><a href="#l160">160</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>tags.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/dom/tags.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2014 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 Utilities for HTML element tag names.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;goog.dom.tags&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/**<tr><td><a id="l24"></a><a href="#l24">24</a><td> * The void elements specified by<tr><td><a id="l25"></a><a href="#l25">25</a><td> * http://www.w3.org/TR/html-markup/syntax.html#void-elements.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @const<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @type {!Object}<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @private<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.dom.tags.VOID_TAGS_ = goog.object.createSet((&#39;area,base,br,col,command,&#39; +<tr><td><a id="l31"></a><a href="#l31">31</a><td> &#39;embed,hr,img,input,keygen,link,meta,param,source,track,wbr&#39;).split(&#39;,&#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> * Checks whether the tag is void (with no contents allowed and no legal end<tr><td><a id="l36"></a><a href="#l36">36</a><td> * tag), for example &#39;br&#39;.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {string} tagName The tag name in lower case.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @return {boolean}<tr><td><a id="l39"></a><a href="#l39">39</a><td> */<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.dom.tags.isVoidTag = function(tagName) {<tr><td><a id="l41"></a><a href="#l41">41</a><td> return goog.dom.tags.VOID_TAGS_[tagName] === true;<tr><td><a id="l42"></a><a href="#l42">42</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>vendor.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/dom/vendor.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 Vendor prefix getters.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.provide(&#39;goog.dom.vendor&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.userAgent&#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> * Returns the JS vendor prefix used in CSS properties. Different vendors<tr><td><a id="l27"></a><a href="#l27">27</a><td> * use different methods of changing the case of the property names.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @return {?string} The JS vendor prefix or null if there is none.<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.dom.vendor.getVendorJsPrefix = function() {<tr><td><a id="l32"></a><a href="#l32">32</a><td> if (goog.userAgent.WEBKIT) {<tr><td><a id="l33"></a><a href="#l33">33</a><td> return &#39;Webkit&#39;;<tr><td><a id="l34"></a><a href="#l34">34</a><td> } else if (goog.userAgent.GECKO) {<tr><td><a id="l35"></a><a href="#l35">35</a><td> return &#39;Moz&#39;;<tr><td><a id="l36"></a><a href="#l36">36</a><td> } else if (goog.userAgent.IE) {<tr><td><a id="l37"></a><a href="#l37">37</a><td> return &#39;ms&#39;;<tr><td><a id="l38"></a><a href="#l38">38</a><td> } else if (goog.userAgent.OPERA) {<tr><td><a id="l39"></a><a href="#l39">39</a><td> return &#39;O&#39;;<tr><td><a id="l40"></a><a href="#l40">40</a><td> }<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td> return null;<tr><td><a id="l43"></a><a href="#l43">43</a><td>};<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Returns the vendor prefix used in CSS properties.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @return {?string} The vendor prefix or null if there is none.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.dom.vendor.getVendorPrefix = function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td> if (goog.userAgent.WEBKIT) {<tr><td><a id="l53"></a><a href="#l53">53</a><td> return &#39;-webkit&#39;;<tr><td><a id="l54"></a><a href="#l54">54</a><td> } else if (goog.userAgent.GECKO) {<tr><td><a id="l55"></a><a href="#l55">55</a><td> return &#39;-moz&#39;;<tr><td><a id="l56"></a><a href="#l56">56</a><td> } else if (goog.userAgent.IE) {<tr><td><a id="l57"></a><a href="#l57">57</a><td> return &#39;-ms&#39;;<tr><td><a id="l58"></a><a href="#l58">58</a><td> } else if (goog.userAgent.OPERA) {<tr><td><a id="l59"></a><a href="#l59">59</a><td> return &#39;-o&#39;;<tr><td><a id="l60"></a><a href="#l60">60</a><td> }<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td> return null;<tr><td><a id="l63"></a><a href="#l63">63</a><td>};<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>/**<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {string} propertyName A property name.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @param {!Object=} opt_object If provided, we verify if the property exists in<tr><td><a id="l69"></a><a href="#l69">69</a><td> * the object.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {?string} A vendor prefixed property name, or null if it does not<tr><td><a id="l71"></a><a href="#l71">71</a><td> * exist.<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.dom.vendor.getPrefixedPropertyName = function(propertyName, opt_object) {<tr><td><a id="l74"></a><a href="#l74">74</a><td> // We first check for a non-prefixed property, if available.<tr><td><a id="l75"></a><a href="#l75">75</a><td> if (opt_object &amp;&amp; propertyName in opt_object) {<tr><td><a id="l76"></a><a href="#l76">76</a><td> return propertyName;<tr><td><a id="l77"></a><a href="#l77">77</a><td> }<tr><td><a id="l78"></a><a href="#l78">78</a><td> var prefix = goog.dom.vendor.getVendorJsPrefix();<tr><td><a id="l79"></a><a href="#l79">79</a><td> if (prefix) {<tr><td><a id="l80"></a><a href="#l80">80</a><td> prefix = prefix.toLowerCase();<tr><td><a id="l81"></a><a href="#l81">81</a><td> var prefixedPropertyName = prefix + goog.string.toTitleCase(propertyName);<tr><td><a id="l82"></a><a href="#l82">82</a><td> return (!goog.isDef(opt_object) || prefixedPropertyName in opt_object) ?<tr><td><a id="l83"></a><a href="#l83">83</a><td> prefixedPropertyName : null;<tr><td><a id="l84"></a><a href="#l84">84</a><td> }<tr><td><a id="l85"></a><a href="#l85">85</a><td> return null;<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td>/**<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @param {string} eventType An event type.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {string} A lower-cased vendor prefixed event type.<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.dom.vendor.getPrefixedEventType = function(eventType) {<tr><td><a id="l94"></a><a href="#l94">94</a><td> var prefix = goog.dom.vendor.getVendorJsPrefix() || &#39;&#39;;<tr><td><a id="l95"></a><a href="#l95">95</a><td> return (prefix + eventType).toLowerCase();<tr><td><a id="l96"></a><a href="#l96">96</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>browserevent.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/browserevent.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 A patched, standardized event object for browser events.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * &lt;pre&gt;<tr><td><a id="l19"></a><a href="#l19">19</a><td> * The patched event object contains the following members:<tr><td><a id="l20"></a><a href="#l20">20</a><td> * - type {string} Event type, e.g. &#39;click&#39;<tr><td><a id="l21"></a><a href="#l21">21</a><td> * - target {Object} The element that actually triggered the event<tr><td><a id="l22"></a><a href="#l22">22</a><td> * - currentTarget {Object} The element the listener is attached to<tr><td><a id="l23"></a><a href="#l23">23</a><td> * - relatedTarget {Object} For mouseover and mouseout, the previous object<tr><td><a id="l24"></a><a href="#l24">24</a><td> * - offsetX {number} X-coordinate relative to target<tr><td><a id="l25"></a><a href="#l25">25</a><td> * - offsetY {number} Y-coordinate relative to target<tr><td><a id="l26"></a><a href="#l26">26</a><td> * - clientX {number} X-coordinate relative to viewport<tr><td><a id="l27"></a><a href="#l27">27</a><td> * - clientY {number} Y-coordinate relative to viewport<tr><td><a id="l28"></a><a href="#l28">28</a><td> * - screenX {number} X-coordinate relative to the edge of the screen<tr><td><a id="l29"></a><a href="#l29">29</a><td> * - screenY {number} Y-coordinate relative to the edge of the screen<tr><td><a id="l30"></a><a href="#l30">30</a><td> * - button {number} Mouse button. Use isButton() to test.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * - keyCode {number} Key-code<tr><td><a id="l32"></a><a href="#l32">32</a><td> * - ctrlKey {boolean} Was ctrl key depressed<tr><td><a id="l33"></a><a href="#l33">33</a><td> * - altKey {boolean} Was alt key depressed<tr><td><a id="l34"></a><a href="#l34">34</a><td> * - shiftKey {boolean} Was shift key depressed<tr><td><a id="l35"></a><a href="#l35">35</a><td> * - metaKey {boolean} Was meta key depressed<tr><td><a id="l36"></a><a href="#l36">36</a><td> * - defaultPrevented {boolean} Whether the default action has been prevented<tr><td><a id="l37"></a><a href="#l37">37</a><td> * - state {Object} History state object<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * NOTE: The keyCode member contains the raw browser keyCode. For normalized<tr><td><a id="l40"></a><a href="#l40">40</a><td> * key and character code use {@link goog.events.KeyHandler}.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * &lt;/pre&gt;<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @author arv@google.com (Erik Arvidsson)<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>goog.provide(&#39;goog.events.BrowserEvent&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.provide(&#39;goog.events.BrowserEvent.MouseButton&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.require(&#39;goog.events.BrowserFeature&#39;);<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.require(&#39;goog.events.Event&#39;);<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.require(&#39;goog.events.EventType&#39;);<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.require(&#39;goog.reflect&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Accepts a browser event object and creates a patched, cross browser event<tr><td><a id="l59"></a><a href="#l59">59</a><td> * object.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * The content of this object will not be initialized if no event object is<tr><td><a id="l61"></a><a href="#l61">61</a><td> * provided. If this is the case, init() needs to be invoked separately.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {Event=} opt_e Browser event object.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {EventTarget=} opt_currentTarget Current target for event.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @constructor<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @extends {goog.events.Event}<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.BrowserEvent = function(opt_e, opt_currentTarget) {<tr><td><a id="l68"></a><a href="#l68">68</a><td> goog.events.BrowserEvent.base(this, &#39;constructor&#39;, opt_e ? opt_e.type : &#39;&#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> /**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Target that fired the event.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @override<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @type {Node}<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.target = null;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * Node that had the listener attached.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @override<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @type {Node|undefined}<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td> this.currentTarget = null;<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td> /**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * For mouseover and mouseout events, the related object for the event.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @type {Node}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td> this.relatedTarget = null;<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td> /**<tr><td><a id="l91"></a><a href="#l91">91</a><td> * X-coordinate relative to target.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @type {number}<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td> this.offsetX = 0;<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td> /**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Y-coordinate relative to target.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @type {number}<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td> this.offsetY = 0;<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> * X-coordinate relative to the window.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @type {number}<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td> this.clientX = 0;<tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td> /**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * Y-coordinate relative to the window.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @type {number}<tr><td><a id="l111"></a><a href="#l111">111</a><td> */<tr><td><a id="l112"></a><a href="#l112">112</a><td> this.clientY = 0;<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td> /**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * X-coordinate relative to the monitor.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @type {number}<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td> this.screenX = 0;<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> * Y-coordinate relative to the monitor.<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @type {number}<tr><td><a id="l123"></a><a href="#l123">123</a><td> */<tr><td><a id="l124"></a><a href="#l124">124</a><td> this.screenY = 0;<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> * Which mouse button was pressed.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @type {number}<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td> this.button = 0;<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td> /**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Keycode of key press.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @type {number}<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td> this.keyCode = 0;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td> /**<tr><td><a id="l139"></a><a href="#l139">139</a><td> * Keycode of key press.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @type {number}<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td> this.charCode = 0;<tr><td><a id="l143"></a><a href="#l143">143</a><td><tr><td><a id="l144"></a><a href="#l144">144</a><td> /**<tr><td><a id="l145"></a><a href="#l145">145</a><td> * Whether control was pressed at time of event.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @type {boolean}<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td> this.ctrlKey = false;<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td> /**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * Whether alt was pressed at time of event.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @type {boolean}<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td> this.altKey = false;<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td> /**<tr><td><a id="l157"></a><a href="#l157">157</a><td> * Whether shift was pressed at time of event.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @type {boolean}<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td> this.shiftKey = false;<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td> /**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Whether the meta key was pressed at time of event.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @type {boolean}<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td> this.metaKey = false;<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> * History state object, only set for PopState events where it&#39;s a copy of the<tr><td><a id="l170"></a><a href="#l170">170</a><td> * state object provided to pushState or replaceState.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @type {Object}<tr><td><a id="l172"></a><a href="#l172">172</a><td> */<tr><td><a id="l173"></a><a href="#l173">173</a><td> this.state = null;<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td> /**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Whether the default platform modifier key was pressed at time of event.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * (This is control for all platforms except Mac, where it&#39;s Meta.)<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @type {boolean}<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td> this.platformModifierKey = false;<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> * The browser event object.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @private {Event}<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td> this.event_ = null;<tr><td><a id="l187"></a><a href="#l187">187</a><td><tr><td><a id="l188"></a><a href="#l188">188</a><td> if (opt_e) {<tr><td><a id="l189"></a><a href="#l189">189</a><td> this.init(opt_e, opt_currentTarget);<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>goog.inherits(goog.events.BrowserEvent, goog.events.Event);<tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Normalized button constants for the mouse.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @enum {number}<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.events.BrowserEvent.MouseButton = {<tr><td><a id="l200"></a><a href="#l200">200</a><td> LEFT: 0,<tr><td><a id="l201"></a><a href="#l201">201</a><td> MIDDLE: 1,<tr><td><a id="l202"></a><a href="#l202">202</a><td> RIGHT: 2<tr><td><a id="l203"></a><a href="#l203">203</a><td>};<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Static data for mapping mouse buttons.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @type {!Array&lt;number&gt;}<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.events.BrowserEvent.IEButtonMap = [<tr><td><a id="l211"></a><a href="#l211">211</a><td> 1, // LEFT<tr><td><a id="l212"></a><a href="#l212">212</a><td> 4, // MIDDLE<tr><td><a id="l213"></a><a href="#l213">213</a><td> 2 // RIGHT<tr><td><a id="l214"></a><a href="#l214">214</a><td>];<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>/**<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Accepts a browser event object and creates a patched, cross browser event<tr><td><a id="l219"></a><a href="#l219">219</a><td> * object.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {Event} e Browser event object.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {EventTarget=} opt_currentTarget Current target for event.<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.events.BrowserEvent.prototype.init = function(e, opt_currentTarget) {<tr><td><a id="l224"></a><a href="#l224">224</a><td> var type = this.type = e.type;<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td> // TODO(nicksantos): Change this.target to type EventTarget.<tr><td><a id="l227"></a><a href="#l227">227</a><td> this.target = /** @type {Node} */ (e.target) || e.srcElement;<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td> // TODO(nicksantos): Change this.currentTarget to type EventTarget.<tr><td><a id="l230"></a><a href="#l230">230</a><td> this.currentTarget = /** @type {Node} */ (opt_currentTarget);<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td> var relatedTarget = /** @type {Node} */ (e.relatedTarget);<tr><td><a id="l233"></a><a href="#l233">233</a><td> if (relatedTarget) {<tr><td><a id="l234"></a><a href="#l234">234</a><td> // There&#39;s a bug in FireFox where sometimes, relatedTarget will be a<tr><td><a id="l235"></a><a href="#l235">235</a><td> // chrome element, and accessing any property of it will get a permission<tr><td><a id="l236"></a><a href="#l236">236</a><td> // denied exception. See:<tr><td><a id="l237"></a><a href="#l237">237</a><td> // https://bugzilla.mozilla.org/show_bug.cgi?id=497780<tr><td><a id="l238"></a><a href="#l238">238</a><td> if (goog.userAgent.GECKO) {<tr><td><a id="l239"></a><a href="#l239">239</a><td> if (!goog.reflect.canAccessProperty(relatedTarget, &#39;nodeName&#39;)) {<tr><td><a id="l240"></a><a href="#l240">240</a><td> relatedTarget = null;<tr><td><a id="l241"></a><a href="#l241">241</a><td> }<tr><td><a id="l242"></a><a href="#l242">242</a><td> }<tr><td><a id="l243"></a><a href="#l243">243</a><td> // TODO(arv): Use goog.events.EventType when it has been refactored into its<tr><td><a id="l244"></a><a href="#l244">244</a><td> // own file.<tr><td><a id="l245"></a><a href="#l245">245</a><td> } else if (type == goog.events.EventType.MOUSEOVER) {<tr><td><a id="l246"></a><a href="#l246">246</a><td> relatedTarget = e.fromElement;<tr><td><a id="l247"></a><a href="#l247">247</a><td> } else if (type == goog.events.EventType.MOUSEOUT) {<tr><td><a id="l248"></a><a href="#l248">248</a><td> relatedTarget = e.toElement;<tr><td><a id="l249"></a><a href="#l249">249</a><td> }<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td> this.relatedTarget = relatedTarget;<tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td> // Webkit emits a lame warning whenever layerX/layerY is accessed.<tr><td><a id="l254"></a><a href="#l254">254</a><td> // http://code.google.com/p/chromium/issues/detail?id=101733<tr><td><a id="l255"></a><a href="#l255">255</a><td> this.offsetX = (goog.userAgent.WEBKIT || e.offsetX !== undefined) ?<tr><td><a id="l256"></a><a href="#l256">256</a><td> e.offsetX : e.layerX;<tr><td><a id="l257"></a><a href="#l257">257</a><td> this.offsetY = (goog.userAgent.WEBKIT || e.offsetY !== undefined) ?<tr><td><a id="l258"></a><a href="#l258">258</a><td> e.offsetY : e.layerY;<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td> this.clientX = e.clientX !== undefined ? e.clientX : e.pageX;<tr><td><a id="l261"></a><a href="#l261">261</a><td> this.clientY = e.clientY !== undefined ? e.clientY : e.pageY;<tr><td><a id="l262"></a><a href="#l262">262</a><td> this.screenX = e.screenX || 0;<tr><td><a id="l263"></a><a href="#l263">263</a><td> this.screenY = e.screenY || 0;<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td> this.button = e.button;<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td> this.keyCode = e.keyCode || 0;<tr><td><a id="l268"></a><a href="#l268">268</a><td> this.charCode = e.charCode || (type == &#39;keypress&#39; ? e.keyCode : 0);<tr><td><a id="l269"></a><a href="#l269">269</a><td> this.ctrlKey = e.ctrlKey;<tr><td><a id="l270"></a><a href="#l270">270</a><td> this.altKey = e.altKey;<tr><td><a id="l271"></a><a href="#l271">271</a><td> this.shiftKey = e.shiftKey;<tr><td><a id="l272"></a><a href="#l272">272</a><td> this.metaKey = e.metaKey;<tr><td><a id="l273"></a><a href="#l273">273</a><td> this.platformModifierKey = goog.userAgent.MAC ? e.metaKey : e.ctrlKey;<tr><td><a id="l274"></a><a href="#l274">274</a><td> this.state = e.state;<tr><td><a id="l275"></a><a href="#l275">275</a><td> this.event_ = e;<tr><td><a id="l276"></a><a href="#l276">276</a><td> if (e.defaultPrevented) {<tr><td><a id="l277"></a><a href="#l277">277</a><td> this.preventDefault();<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><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> * Tests to see which button was pressed during the event. This is really only<tr><td><a id="l284"></a><a href="#l284">284</a><td> * useful in IE and Gecko browsers. And in IE, it&#39;s only useful for<tr><td><a id="l285"></a><a href="#l285">285</a><td> * mousedown/mouseup events, because click only fires for the left mouse button.<tr><td><a id="l286"></a><a href="#l286">286</a><td> *<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Safari 2 only reports the left button being clicked, and uses the value &#39;1&#39;<tr><td><a id="l288"></a><a href="#l288">288</a><td> * instead of 0. Opera only reports a mousedown event for the middle button, and<tr><td><a id="l289"></a><a href="#l289">289</a><td> * no mouse events for the right button. Opera has default behavior for left and<tr><td><a id="l290"></a><a href="#l290">290</a><td> * middle click that can only be overridden via a configuration setting.<tr><td><a id="l291"></a><a href="#l291">291</a><td> *<tr><td><a id="l292"></a><a href="#l292">292</a><td> * There&#39;s a nice table of this mess at http://www.unixpapa.com/js/mouse.html.<tr><td><a id="l293"></a><a href="#l293">293</a><td> *<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {goog.events.BrowserEvent.MouseButton} button The button<tr><td><a id="l295"></a><a href="#l295">295</a><td> * to test for.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @return {boolean} True if button was pressed.<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.events.BrowserEvent.prototype.isButton = function(button) {<tr><td><a id="l299"></a><a href="#l299">299</a><td> if (!goog.events.BrowserFeature.HAS_W3C_BUTTON) {<tr><td><a id="l300"></a><a href="#l300">300</a><td> if (this.type == &#39;click&#39;) {<tr><td><a id="l301"></a><a href="#l301">301</a><td> return button == goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l302"></a><a href="#l302">302</a><td> } else {<tr><td><a id="l303"></a><a href="#l303">303</a><td> return !!(this.event_.button &amp;<tr><td><a id="l304"></a><a href="#l304">304</a><td> goog.events.BrowserEvent.IEButtonMap[button]);<tr><td><a id="l305"></a><a href="#l305">305</a><td> }<tr><td><a id="l306"></a><a href="#l306">306</a><td> } else {<tr><td><a id="l307"></a><a href="#l307">307</a><td> return this.event_.button == button;<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Whether this has an &quot;action&quot;-producing mouse button.<tr><td><a id="l314"></a><a href="#l314">314</a><td> *<tr><td><a id="l315"></a><a href="#l315">315</a><td> * By definition, this includes left-click on windows/linux, and left-click<tr><td><a id="l316"></a><a href="#l316">316</a><td> * without the ctrl key on Macs.<tr><td><a id="l317"></a><a href="#l317">317</a><td> *<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @return {boolean} The result.<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>goog.events.BrowserEvent.prototype.isMouseActionButton = function() {<tr><td><a id="l321"></a><a href="#l321">321</a><td> // Webkit does not ctrl+click to be a right-click, so we<tr><td><a id="l322"></a><a href="#l322">322</a><td> // normalize it to behave like Gecko and Opera.<tr><td><a id="l323"></a><a href="#l323">323</a><td> return this.isButton(goog.events.BrowserEvent.MouseButton.LEFT) &amp;&amp;<tr><td><a id="l324"></a><a href="#l324">324</a><td> !(goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.MAC &amp;&amp; this.ctrlKey);<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @override<tr><td><a id="l330"></a><a href="#l330">330</a><td> */<tr><td><a id="l331"></a><a href="#l331">331</a><td>goog.events.BrowserEvent.prototype.stopPropagation = function() {<tr><td><a id="l332"></a><a href="#l332">332</a><td> goog.events.BrowserEvent.superClass_.stopPropagation.call(this);<tr><td><a id="l333"></a><a href="#l333">333</a><td> if (this.event_.stopPropagation) {<tr><td><a id="l334"></a><a href="#l334">334</a><td> this.event_.stopPropagation();<tr><td><a id="l335"></a><a href="#l335">335</a><td> } else {<tr><td><a id="l336"></a><a href="#l336">336</a><td> this.event_.cancelBubble = true;<tr><td><a id="l337"></a><a href="#l337">337</a><td> }<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @override<tr><td><a id="l343"></a><a href="#l343">343</a><td> */<tr><td><a id="l344"></a><a href="#l344">344</a><td>goog.events.BrowserEvent.prototype.preventDefault = function() {<tr><td><a id="l345"></a><a href="#l345">345</a><td> goog.events.BrowserEvent.superClass_.preventDefault.call(this);<tr><td><a id="l346"></a><a href="#l346">346</a><td> var be = this.event_;<tr><td><a id="l347"></a><a href="#l347">347</a><td> if (!be.preventDefault) {<tr><td><a id="l348"></a><a href="#l348">348</a><td> be.returnValue = false;<tr><td><a id="l349"></a><a href="#l349">349</a><td> if (goog.events.BrowserFeature.SET_KEY_CODE_TO_PREVENT_DEFAULT) {<tr><td><a id="l350"></a><a href="#l350">350</a><td> /** @preserveTry */<tr><td><a id="l351"></a><a href="#l351">351</a><td> try {<tr><td><a id="l352"></a><a href="#l352">352</a><td> // Most keys can be prevented using returnValue. Some special keys<tr><td><a id="l353"></a><a href="#l353">353</a><td> // require setting the keyCode to -1 as well:<tr><td><a id="l354"></a><a href="#l354">354</a><td> //<tr><td><a id="l355"></a><a href="#l355">355</a><td> // In IE7:<tr><td><a id="l356"></a><a href="#l356">356</a><td> // F3, F5, F10, F11, Ctrl+P, Crtl+O, Ctrl+F (these are taken from IE6)<tr><td><a id="l357"></a><a href="#l357">357</a><td> //<tr><td><a id="l358"></a><a href="#l358">358</a><td> // In IE8:<tr><td><a id="l359"></a><a href="#l359">359</a><td> // Ctrl+P, Crtl+O, Ctrl+F (F1-F12 cannot be stopped through the event)<tr><td><a id="l360"></a><a href="#l360">360</a><td> //<tr><td><a id="l361"></a><a href="#l361">361</a><td> // We therefore do this for all function keys as well as when Ctrl key<tr><td><a id="l362"></a><a href="#l362">362</a><td> // is pressed.<tr><td><a id="l363"></a><a href="#l363">363</a><td> var VK_F1 = 112;<tr><td><a id="l364"></a><a href="#l364">364</a><td> var VK_F12 = 123;<tr><td><a id="l365"></a><a href="#l365">365</a><td> if (be.ctrlKey || be.keyCode &gt;= VK_F1 &amp;&amp; be.keyCode &lt;= VK_F12) {<tr><td><a id="l366"></a><a href="#l366">366</a><td> be.keyCode = -1;<tr><td><a id="l367"></a><a href="#l367">367</a><td> }<tr><td><a id="l368"></a><a href="#l368">368</a><td> } catch (ex) {<tr><td><a id="l369"></a><a href="#l369">369</a><td> // IE throws an &#39;access denied&#39; exception when trying to change<tr><td><a id="l370"></a><a href="#l370">370</a><td> // keyCode in some situations (e.g. srcElement is input[type=file],<tr><td><a id="l371"></a><a href="#l371">371</a><td> // or srcElement is an anchor tag rewritten by parent&#39;s innerHTML).<tr><td><a id="l372"></a><a href="#l372">372</a><td> // Do nothing in this case.<tr><td><a id="l373"></a><a href="#l373">373</a><td> }<tr><td><a id="l374"></a><a href="#l374">374</a><td> }<tr><td><a id="l375"></a><a href="#l375">375</a><td> } else {<tr><td><a id="l376"></a><a href="#l376">376</a><td> be.preventDefault();<tr><td><a id="l377"></a><a href="#l377">377</a><td> }<tr><td><a id="l378"></a><a href="#l378">378</a><td>};<tr><td><a id="l379"></a><a href="#l379">379</a><td><tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td>/**<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @return {Event} The underlying browser event object.<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>goog.events.BrowserEvent.prototype.getBrowserEvent = function() {<tr><td><a id="l385"></a><a href="#l385">385</a><td> return this.event_;<tr><td><a id="l386"></a><a href="#l386">386</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>browserfeature.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/browserfeature.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 Browser capability checks for the events package.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.BrowserFeature&#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>goog.require(&#39;goog.userAgent&#39;);<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> * Enum of browser capabilities.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @enum {boolean}<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.events.BrowserFeature = {<tr><td><a id="l31"></a><a href="#l31">31</a><td> /**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Whether the button attribute of the event is W3C compliant. False in<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Internet Explorer prior to version 9; document-version dependent.<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td> HAS_W3C_BUTTON: !goog.userAgent.IE ||<tr><td><a id="l36"></a><a href="#l36">36</a><td> goog.userAgent.isDocumentModeOrHigher(9),<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td> /**<tr><td><a id="l39"></a><a href="#l39">39</a><td> * Whether the browser supports full W3C event model.<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td> HAS_W3C_EVENT_SUPPORT: !goog.userAgent.IE ||<tr><td><a id="l42"></a><a href="#l42">42</a><td> goog.userAgent.isDocumentModeOrHigher(9),<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> * To prevent default in IE7-8 for certain keydown events we need set the<tr><td><a id="l46"></a><a href="#l46">46</a><td> * keyCode to -1.<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td> SET_KEY_CODE_TO_PREVENT_DEFAULT: goog.userAgent.IE &amp;&amp;<tr><td><a id="l49"></a><a href="#l49">49</a><td> !goog.userAgent.isVersionOrHigher(&#39;9&#39;),<tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td> /**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Whether the {@code navigator.onLine} property is supported.<tr><td><a id="l53"></a><a href="#l53">53</a><td> */<tr><td><a id="l54"></a><a href="#l54">54</a><td> HAS_NAVIGATOR_ONLINE_PROPERTY: !goog.userAgent.WEBKIT ||<tr><td><a id="l55"></a><a href="#l55">55</a><td> goog.userAgent.isVersionOrHigher(&#39;528&#39;),<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> * Whether HTML5 network online/offline events are supported.<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td> HAS_HTML5_NETWORK_EVENT_SUPPORT:<tr><td><a id="l61"></a><a href="#l61">61</a><td> goog.userAgent.GECKO &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;1.9b&#39;) ||<tr><td><a id="l62"></a><a href="#l62">62</a><td> goog.userAgent.IE &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;8&#39;) ||<tr><td><a id="l63"></a><a href="#l63">63</a><td> goog.userAgent.OPERA &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;9.5&#39;) ||<tr><td><a id="l64"></a><a href="#l64">64</a><td> goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;528&#39;),<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> * Whether HTML5 network events fire on document.body, or otherwise the<tr><td><a id="l68"></a><a href="#l68">68</a><td> * window.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td> HTML5_NETWORK_EVENTS_FIRE_ON_BODY:<tr><td><a id="l71"></a><a href="#l71">71</a><td> goog.userAgent.GECKO &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;8&#39;) ||<tr><td><a id="l72"></a><a href="#l72">72</a><td> goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;9&#39;),<tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td> /**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Whether touch is enabled in the browser.<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td> TOUCH_ENABLED:<tr><td><a id="l78"></a><a href="#l78">78</a><td> (&#39;ontouchstart&#39; in goog.global ||<tr><td><a id="l79"></a><a href="#l79">79</a><td> !!(goog.global[&#39;document&#39;] &amp;&amp;<tr><td><a id="l80"></a><a href="#l80">80</a><td> document.documentElement &amp;&amp;<tr><td><a id="l81"></a><a href="#l81">81</a><td> &#39;ontouchstart&#39; in document.documentElement) ||<tr><td><a id="l82"></a><a href="#l82">82</a><td> // IE10 uses non-standard touch events, so it has a different check.<tr><td><a id="l83"></a><a href="#l83">83</a><td> !!(goog.global[&#39;navigator&#39;] &amp;&amp;<tr><td><a id="l84"></a><a href="#l84">84</a><td> goog.global[&#39;navigator&#39;][&#39;msMaxTouchPoints&#39;]))<tr><td><a id="l85"></a><a href="#l85">85</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>event.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/event.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 A base class for event objects.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.Event&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.events.EventLike&#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> * goog.events.Event no longer depends on goog.Disposable. Keep requiring<tr><td><a id="l26"></a><a href="#l26">26</a><td> * goog.Disposable here to not break projects which assume this dependency.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @suppress {extraRequire}<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.Disposable&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.events.EventId&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * A typedef for event like objects that are dispatchable via the<tr><td><a id="l35"></a><a href="#l35">35</a><td> * goog.events.dispatchEvent function. strings are treated as the type for a<tr><td><a id="l36"></a><a href="#l36">36</a><td> * goog.events.Event. Objects are treated as an extension of a new<tr><td><a id="l37"></a><a href="#l37">37</a><td> * goog.events.Event with the type property of the object being used as the type<tr><td><a id="l38"></a><a href="#l38">38</a><td> * of the Event.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @typedef {string|Object|goog.events.Event|goog.events.EventId}<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.EventLike;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * A base class for event objects, so that they can support preventDefault and<tr><td><a id="l47"></a><a href="#l47">47</a><td> * stopPropagation.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {string|!goog.events.EventId} type Event Type.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {Object=} opt_target Reference to the object that is the target of<tr><td><a id="l51"></a><a href="#l51">51</a><td> * this event. It has to implement the {@code EventTarget} interface<tr><td><a id="l52"></a><a href="#l52">52</a><td> * declared at {@link http://developer.mozilla.org/en/DOM/EventTarget}.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @constructor<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.Event = function(type, opt_target) {<tr><td><a id="l56"></a><a href="#l56">56</a><td> /**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * Event type.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @type {string}<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td> this.type = type instanceof goog.events.EventId ? String(type) : type;<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td> /**<tr><td><a id="l63"></a><a href="#l63">63</a><td> * TODO(tbreisacher): The type should probably be<tr><td><a id="l64"></a><a href="#l64">64</a><td> * EventTarget|goog.events.EventTarget.<tr><td><a id="l65"></a><a href="#l65">65</a><td> *<tr><td><a id="l66"></a><a href="#l66">66</a><td> * Target of the event.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @type {Object|undefined}<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td> this.target = opt_target;<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> * Object that had the listener attached.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @type {Object|undefined}<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.currentTarget = this.target;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * Whether to cancel the event in internal capture/bubble processing for IE.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @type {boolean}<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @public<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l82"></a><a href="#l82">82</a><td> * outside this package is strongly discouraged.<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td> this.propagationStopped_ = false;<tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td> /**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Whether the default action has been prevented.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * This is a property to match the W3C specification at<tr><td><a id="l89"></a><a href="#l89">89</a><td> * {@link http://www.w3.org/TR/DOM-Level-3-Events/<tr><td><a id="l90"></a><a href="#l90">90</a><td> * #events-event-type-defaultPrevented}.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * Must be treated as read-only outside the class.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @type {boolean}<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td> this.defaultPrevented = false;<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td> /**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Return value for in internal capture/bubble processing for IE.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @type {boolean}<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @public<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l101"></a><a href="#l101">101</a><td> * outside this package is strongly discouraged.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td> this.returnValue_ = true;<tr><td><a id="l104"></a><a href="#l104">104</a><td>};<tr><td><a id="l105"></a><a href="#l105">105</a><td><tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>/**<tr><td><a id="l108"></a><a href="#l108">108</a><td> * Stops event propagation.<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.Event.prototype.stopPropagation = function() {<tr><td><a id="l111"></a><a href="#l111">111</a><td> this.propagationStopped_ = true;<tr><td><a id="l112"></a><a href="#l112">112</a><td>};<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>/**<tr><td><a id="l116"></a><a href="#l116">116</a><td> * Prevents the default action, for example a link redirecting to a url.<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.Event.prototype.preventDefault = function() {<tr><td><a id="l119"></a><a href="#l119">119</a><td> this.defaultPrevented = true;<tr><td><a id="l120"></a><a href="#l120">120</a><td> this.returnValue_ = false;<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Stops the propagation of the event. It is equivalent to<tr><td><a id="l126"></a><a href="#l126">126</a><td> * {@code e.stopPropagation()}, but can be used as the callback argument of<tr><td><a id="l127"></a><a href="#l127">127</a><td> * {@link goog.events.listen} without declaring another function.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {!goog.events.Event} e An event.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>goog.events.Event.stopPropagation = function(e) {<tr><td><a id="l131"></a><a href="#l131">131</a><td> e.stopPropagation();<tr><td><a id="l132"></a><a href="#l132">132</a><td>};<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Prevents the default action. It is equivalent to<tr><td><a id="l137"></a><a href="#l137">137</a><td> * {@code e.preventDefault()}, but can be used as the callback argument of<tr><td><a id="l138"></a><a href="#l138">138</a><td> * {@link goog.events.listen} without declaring another function.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {!goog.events.Event} e An event.<tr><td><a id="l140"></a><a href="#l140">140</a><td> */<tr><td><a id="l141"></a><a href="#l141">141</a><td>goog.events.Event.preventDefault = function(e) {<tr><td><a id="l142"></a><a href="#l142">142</a><td> e.preventDefault();<tr><td><a id="l143"></a><a href="#l143">143</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>eventid.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/eventid.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>goog.provide(&#39;goog.events.EventId&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * A templated class that is used when registering for events. Typical usage:<tr><td><a id="l21"></a><a href="#l21">21</a><td> * &lt;code&gt;<tr><td><a id="l22"></a><a href="#l22">22</a><td> * /** @type {goog.events.EventId&lt;MyEventObj&gt;}<tr><td><a id="l23"></a><a href="#l23">23</a><td> * var myEventId = new goog.events.EventId(<tr><td><a id="l24"></a><a href="#l24">24</a><td> * goog.events.getUniqueId((&#39;someEvent&#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> * // No need to cast or declare here since the compiler knows the correct<tr><td><a id="l27"></a><a href="#l27">27</a><td> * // type of &#39;evt&#39; (MyEventObj).<tr><td><a id="l28"></a><a href="#l28">28</a><td> * something.listen(myEventId, function(evt) {});<tr><td><a id="l29"></a><a href="#l29">29</a><td> * &lt;/code&gt;<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {string} eventId<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @template T<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @constructor<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @struct<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @final<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.events.EventId = function(eventId) {<tr><td><a id="l38"></a><a href="#l38">38</a><td> /** @const */ this.id = eventId;<tr><td><a id="l39"></a><a href="#l39">39</a><td>};<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @override<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.EventId.prototype.toString = function() {<tr><td><a id="l46"></a><a href="#l46">46</a><td> return this.id;<tr><td><a id="l47"></a><a href="#l47">47</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>