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
package/docs/source/lib/goog/asserts/asserts.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>asserts.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/asserts/asserts.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 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 to check the preconditions, postconditions and<tr><td><a id="l17"></a><a href="#l17">17</a><td> * invariants runtime.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * Methods in this package should be given special treatment by the compiler<tr><td><a id="l20"></a><a href="#l20">20</a><td> * for type-inference. For example, &lt;code&gt;goog.asserts.assert(foo)&lt;/code&gt;<tr><td><a id="l21"></a><a href="#l21">21</a><td> * will restrict &lt;code&gt;foo&lt;/code&gt; to a truthy value.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * The compiler has an option to disable asserts. So code like:<tr><td><a id="l24"></a><a href="#l24">24</a><td> * &lt;code&gt;<tr><td><a id="l25"></a><a href="#l25">25</a><td> * var x = goog.asserts.assert(foo()); goog.asserts.assert(bar());<tr><td><a id="l26"></a><a href="#l26">26</a><td> * &lt;/code&gt;<tr><td><a id="l27"></a><a href="#l27">27</a><td> * will be transformed into:<tr><td><a id="l28"></a><a href="#l28">28</a><td> * &lt;code&gt;<tr><td><a id="l29"></a><a href="#l29">29</a><td> * var x = foo();<tr><td><a id="l30"></a><a href="#l30">30</a><td> * &lt;/code&gt;<tr><td><a id="l31"></a><a href="#l31">31</a><td> * The compiler will leave in foo() (because its return value is used),<tr><td><a id="l32"></a><a href="#l32">32</a><td> * but it will remove bar() because it assumes it does not have side-effects.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @author agrieve@google.com (Andrew Grieve)<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<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.provide(&#39;goog.asserts&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.provide(&#39;goog.asserts.AssertionError&#39;);<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.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.string&#39;);<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> * @define {boolean} Whether to strip out asserts or to leave them in.<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.define(&#39;goog.asserts.ENABLE_ASSERTS&#39;, goog.DEBUG);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Error object for failed assertions.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {string} messagePattern The pattern that was used to form message.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!Array&lt;*&gt;} messageArgs The items to substitute into the pattern.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @constructor<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @extends {goog.debug.Error}<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @final<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.asserts.AssertionError = function(messagePattern, messageArgs) {<tr><td><a id="l61"></a><a href="#l61">61</a><td> messageArgs.unshift(messagePattern);<tr><td><a id="l62"></a><a href="#l62">62</a><td> goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));<tr><td><a id="l63"></a><a href="#l63">63</a><td> // Remove the messagePattern afterwards to avoid permenantly modifying the<tr><td><a id="l64"></a><a href="#l64">64</a><td> // passed in array.<tr><td><a id="l65"></a><a href="#l65">65</a><td> messageArgs.shift();<tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td> /**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * The message pattern used to format the error message. Error handlers can<tr><td><a id="l69"></a><a href="#l69">69</a><td> * use this to uniquely identify the assertion.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @type {string}<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td> this.messagePattern = messagePattern;<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.inherits(goog.asserts.AssertionError, goog.debug.Error);<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/** @override */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.asserts.AssertionError.prototype.name = &#39;AssertionError&#39;;<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> * The default error handler.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @param {!goog.asserts.AssertionError} e The exception to be handled.<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td>goog.asserts.DEFAULT_ERROR_HANDLER = function(e) { throw e; };<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> * The handler responsible for throwing or logging assertion errors.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @private {function(!goog.asserts.AssertionError)}<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.asserts.errorHandler_ = goog.asserts.DEFAULT_ERROR_HANDLER;<tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>/**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * Throws an exception with the given message and &quot;Assertion failed&quot; prefixed<tr><td><a id="l97"></a><a href="#l97">97</a><td> * onto it.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {string} defaultMessage The message to use if givenMessage is empty.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {Array&lt;*&gt;} defaultArgs The substitution arguments for defaultMessage.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string|undefined} givenMessage Message supplied by the caller.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {Array&lt;*&gt;} givenArgs The substitution arguments for givenMessage.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @private<tr><td><a id="l104"></a><a href="#l104">104</a><td> */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.asserts.doAssertFailure_ =<tr><td><a id="l106"></a><a href="#l106">106</a><td> function(defaultMessage, defaultArgs, givenMessage, givenArgs) {<tr><td><a id="l107"></a><a href="#l107">107</a><td> var message = &#39;Assertion failed&#39;;<tr><td><a id="l108"></a><a href="#l108">108</a><td> if (givenMessage) {<tr><td><a id="l109"></a><a href="#l109">109</a><td> message += &#39;: &#39; + givenMessage;<tr><td><a id="l110"></a><a href="#l110">110</a><td> var args = givenArgs;<tr><td><a id="l111"></a><a href="#l111">111</a><td> } else if (defaultMessage) {<tr><td><a id="l112"></a><a href="#l112">112</a><td> message += &#39;: &#39; + defaultMessage;<tr><td><a id="l113"></a><a href="#l113">113</a><td> args = defaultArgs;<tr><td><a id="l114"></a><a href="#l114">114</a><td> }<tr><td><a id="l115"></a><a href="#l115">115</a><td> // The &#39;&#39; + works around an Opera 10 bug in the unit tests. Without it,<tr><td><a id="l116"></a><a href="#l116">116</a><td> // a stack trace is added to var message above. With this, a stack trace is<tr><td><a id="l117"></a><a href="#l117">117</a><td> // not added until this line (it causes the extra garbage to be added after<tr><td><a id="l118"></a><a href="#l118">118</a><td> // the assertion message instead of in the middle of it).<tr><td><a id="l119"></a><a href="#l119">119</a><td> var e = new goog.asserts.AssertionError(&#39;&#39; + message, args || []);<tr><td><a id="l120"></a><a href="#l120">120</a><td> goog.asserts.errorHandler_(e);<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> * Sets a custom error handler that can be used to customize the behavior of<tr><td><a id="l126"></a><a href="#l126">126</a><td> * assertion failures, for example by turning all assertion failures into log<tr><td><a id="l127"></a><a href="#l127">127</a><td> * messages.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {function(!goog.asserts.AssertionError)} errorHandler<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.asserts.setErrorHandler = function(errorHandler) {<tr><td><a id="l131"></a><a href="#l131">131</a><td> if (goog.asserts.ENABLE_ASSERTS) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> goog.asserts.errorHandler_ = errorHandler;<tr><td><a id="l133"></a><a href="#l133">133</a><td> }<tr><td><a id="l134"></a><a href="#l134">134</a><td>};<tr><td><a id="l135"></a><a href="#l135">135</a><td><tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is<tr><td><a id="l139"></a><a href="#l139">139</a><td> * true.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @template T<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {T} condition The condition to check.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {T} The value of the condition.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @throws {goog.asserts.AssertionError} When the condition evaluates to false.<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.asserts.assert = function(condition, opt_message, var_args) {<tr><td><a id="l148"></a><a href="#l148">148</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !condition) {<tr><td><a id="l149"></a><a href="#l149">149</a><td> goog.asserts.doAssertFailure_(&#39;&#39;, null, opt_message,<tr><td><a id="l150"></a><a href="#l150">150</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l151"></a><a href="#l151">151</a><td> }<tr><td><a id="l152"></a><a href="#l152">152</a><td> return condition;<tr><td><a id="l153"></a><a href="#l153">153</a><td>};<tr><td><a id="l154"></a><a href="#l154">154</a><td><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> * Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case<tr><td><a id="l158"></a><a href="#l158">158</a><td> * when we want to add a check in the unreachable area like switch-case<tr><td><a id="l159"></a><a href="#l159">159</a><td> * statement:<tr><td><a id="l160"></a><a href="#l160">160</a><td> *<tr><td><a id="l161"></a><a href="#l161">161</a><td> * &lt;pre&gt;<tr><td><a id="l162"></a><a href="#l162">162</a><td> * switch(type) {<tr><td><a id="l163"></a><a href="#l163">163</a><td> * case FOO: doSomething(); break;<tr><td><a id="l164"></a><a href="#l164">164</a><td> * case BAR: doSomethingElse(); break;<tr><td><a id="l165"></a><a href="#l165">165</a><td> * default: goog.assert.fail(&#39;Unrecognized type: &#39; + type);<tr><td><a id="l166"></a><a href="#l166">166</a><td> * // We have only 2 types - &quot;default:&quot; section is unreachable code.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * }<tr><td><a id="l168"></a><a href="#l168">168</a><td> * &lt;/pre&gt;<tr><td><a id="l169"></a><a href="#l169">169</a><td> *<tr><td><a id="l170"></a><a href="#l170">170</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @throws {goog.asserts.AssertionError} Failure.<tr><td><a id="l173"></a><a href="#l173">173</a><td> */<tr><td><a id="l174"></a><a href="#l174">174</a><td>goog.asserts.fail = function(opt_message, var_args) {<tr><td><a id="l175"></a><a href="#l175">175</a><td> if (goog.asserts.ENABLE_ASSERTS) {<tr><td><a id="l176"></a><a href="#l176">176</a><td> goog.asserts.errorHandler_(new goog.asserts.AssertionError(<tr><td><a id="l177"></a><a href="#l177">177</a><td> &#39;Failure&#39; + (opt_message ? &#39;: &#39; + opt_message : &#39;&#39;),<tr><td><a id="l178"></a><a href="#l178">178</a><td> Array.prototype.slice.call(arguments, 1)));<tr><td><a id="l179"></a><a href="#l179">179</a><td> }<tr><td><a id="l180"></a><a href="#l180">180</a><td>};<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {*} value The value to check.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {number} The value, guaranteed to be a number when asserts enabled.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a id="l190"></a><a href="#l190">190</a><td> */<tr><td><a id="l191"></a><a href="#l191">191</a><td>goog.asserts.assertNumber = function(value, opt_message, var_args) {<tr><td><a id="l192"></a><a href="#l192">192</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isNumber(value)) {<tr><td><a id="l193"></a><a href="#l193">193</a><td> goog.asserts.doAssertFailure_(&#39;Expected number but got %s: %s.&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l195"></a><a href="#l195">195</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l196"></a><a href="#l196">196</a><td> }<tr><td><a id="l197"></a><a href="#l197">197</a><td> return /** @type {number} */ (value);<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<tr><td><a id="l199"></a><a href="#l199">199</a><td><tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td>/**<tr><td><a id="l202"></a><a href="#l202">202</a><td> * Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {*} value The value to check.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {string} The value, guaranteed to be a string when asserts enabled.<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @throws {goog.asserts.AssertionError} When the value is not a string.<tr><td><a id="l208"></a><a href="#l208">208</a><td> */<tr><td><a id="l209"></a><a href="#l209">209</a><td>goog.asserts.assertString = function(value, opt_message, var_args) {<tr><td><a id="l210"></a><a href="#l210">210</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isString(value)) {<tr><td><a id="l211"></a><a href="#l211">211</a><td> goog.asserts.doAssertFailure_(&#39;Expected string but got %s: %s.&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l213"></a><a href="#l213">213</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l214"></a><a href="#l214">214</a><td> }<tr><td><a id="l215"></a><a href="#l215">215</a><td> return /** @type {string} */ (value);<tr><td><a id="l216"></a><a href="#l216">216</a><td>};<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td><tr><td><a id="l219"></a><a href="#l219">219</a><td>/**<tr><td><a id="l220"></a><a href="#l220">220</a><td> * Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {*} value The value to check.<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @return {!Function} The value, guaranteed to be a function when asserts<tr><td><a id="l225"></a><a href="#l225">225</a><td> * enabled.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @throws {goog.asserts.AssertionError} When the value is not a function.<tr><td><a id="l227"></a><a href="#l227">227</a><td> */<tr><td><a id="l228"></a><a href="#l228">228</a><td>goog.asserts.assertFunction = function(value, opt_message, var_args) {<tr><td><a id="l229"></a><a href="#l229">229</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isFunction(value)) {<tr><td><a id="l230"></a><a href="#l230">230</a><td> goog.asserts.doAssertFailure_(&#39;Expected function but got %s: %s.&#39;,<tr><td><a id="l231"></a><a href="#l231">231</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l232"></a><a href="#l232">232</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l233"></a><a href="#l233">233</a><td> }<tr><td><a id="l234"></a><a href="#l234">234</a><td> return /** @type {!Function} */ (value);<tr><td><a id="l235"></a><a href="#l235">235</a><td>};<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {*} value The value to check.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @return {!Object} The value, guaranteed to be a non-null object.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @throws {goog.asserts.AssertionError} When the value is not an object.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>goog.asserts.assertObject = function(value, opt_message, var_args) {<tr><td><a id="l247"></a><a href="#l247">247</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isObject(value)) {<tr><td><a id="l248"></a><a href="#l248">248</a><td> goog.asserts.doAssertFailure_(&#39;Expected object but got %s: %s.&#39;,<tr><td><a id="l249"></a><a href="#l249">249</a><td> [goog.typeOf(value), value],<tr><td><a id="l250"></a><a href="#l250">250</a><td> opt_message, Array.prototype.slice.call(arguments, 2));<tr><td><a id="l251"></a><a href="#l251">251</a><td> }<tr><td><a id="l252"></a><a href="#l252">252</a><td> return /** @type {!Object} */ (value);<tr><td><a id="l253"></a><a href="#l253">253</a><td>};<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td>/**<tr><td><a id="l257"></a><a href="#l257">257</a><td> * Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @param {*} value The value to check.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @return {!Array&lt;?&gt;} The value, guaranteed to be a non-null array.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @throws {goog.asserts.AssertionError} When the value is not an array.<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>goog.asserts.assertArray = function(value, opt_message, var_args) {<tr><td><a id="l265"></a><a href="#l265">265</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isArray(value)) {<tr><td><a id="l266"></a><a href="#l266">266</a><td> goog.asserts.doAssertFailure_(&#39;Expected array but got %s: %s.&#39;,<tr><td><a id="l267"></a><a href="#l267">267</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l268"></a><a href="#l268">268</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l269"></a><a href="#l269">269</a><td> }<tr><td><a id="l270"></a><a href="#l270">270</a><td> return /** @type {!Array&lt;?&gt;} */ (value);<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td>/**<tr><td><a id="l275"></a><a href="#l275">275</a><td> * Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @param {*} value The value to check.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @return {boolean} The value, guaranteed to be a boolean when asserts are<tr><td><a id="l280"></a><a href="#l280">280</a><td> * enabled.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @throws {goog.asserts.AssertionError} When the value is not a boolean.<tr><td><a id="l282"></a><a href="#l282">282</a><td> */<tr><td><a id="l283"></a><a href="#l283">283</a><td>goog.asserts.assertBoolean = function(value, opt_message, var_args) {<tr><td><a id="l284"></a><a href="#l284">284</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isBoolean(value)) {<tr><td><a id="l285"></a><a href="#l285">285</a><td> goog.asserts.doAssertFailure_(&#39;Expected boolean but got %s: %s.&#39;,<tr><td><a id="l286"></a><a href="#l286">286</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l287"></a><a href="#l287">287</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l288"></a><a href="#l288">288</a><td> }<tr><td><a id="l289"></a><a href="#l289">289</a><td> return /** @type {boolean} */ (value);<tr><td><a id="l290"></a><a href="#l290">290</a><td>};<tr><td><a id="l291"></a><a href="#l291">291</a><td><tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td>/**<tr><td><a id="l294"></a><a href="#l294">294</a><td> * Checks if the value is a DOM Element if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {*} value The value to check.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @return {!Element} The value, likely to be a DOM Element when asserts are<tr><td><a id="l299"></a><a href="#l299">299</a><td> * enabled.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @throws {goog.asserts.AssertionError} When the value is not an Element.<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td>goog.asserts.assertElement = function(value, opt_message, var_args) {<tr><td><a id="l303"></a><a href="#l303">303</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; (!goog.isObject(value) ||<tr><td><a id="l304"></a><a href="#l304">304</a><td> value.nodeType != goog.dom.NodeType.ELEMENT)) {<tr><td><a id="l305"></a><a href="#l305">305</a><td> goog.asserts.doAssertFailure_(&#39;Expected Element but got %s: %s.&#39;,<tr><td><a id="l306"></a><a href="#l306">306</a><td> [goog.typeOf(value), value], opt_message,<tr><td><a id="l307"></a><a href="#l307">307</a><td> Array.prototype.slice.call(arguments, 2));<tr><td><a id="l308"></a><a href="#l308">308</a><td> }<tr><td><a id="l309"></a><a href="#l309">309</a><td> return /** @type {!Element} */ (value);<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>/**<tr><td><a id="l314"></a><a href="#l314">314</a><td> * Checks if the value is an instance of the user-defined type if<tr><td><a id="l315"></a><a href="#l315">315</a><td> * goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l316"></a><a href="#l316">316</a><td> *<tr><td><a id="l317"></a><a href="#l317">317</a><td> * The compiler may tighten the type returned by this function.<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 {*} value The value to check.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {function(new: T, ...)} type A user-defined constructor.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @throws {goog.asserts.AssertionError} When the value is not an instance of<tr><td><a id="l324"></a><a href="#l324">324</a><td> * type.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @return {T}<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @template T<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {<tr><td><a id="l329"></a><a href="#l329">329</a><td> if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !(value instanceof type)) {<tr><td><a id="l330"></a><a href="#l330">330</a><td> goog.asserts.doAssertFailure_(&#39;Expected instanceof %s but got %s.&#39;,<tr><td><a id="l331"></a><a href="#l331">331</a><td> [goog.asserts.getType_(type), goog.asserts.getType_(value)],<tr><td><a id="l332"></a><a href="#l332">332</a><td> opt_message, Array.prototype.slice.call(arguments, 3));<tr><td><a id="l333"></a><a href="#l333">333</a><td> }<tr><td><a id="l334"></a><a href="#l334">334</a><td> return value;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Checks that no enumerable keys are present in Object.prototype. Such keys<tr><td><a id="l340"></a><a href="#l340">340</a><td> * would break most code that use {@code for (var ... in ...)} loops.<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>goog.asserts.assertObjectPrototypeIsIntact = function() {<tr><td><a id="l343"></a><a href="#l343">343</a><td> for (var key in Object.prototype) {<tr><td><a id="l344"></a><a href="#l344">344</a><td> goog.asserts.fail(key + &#39; should not be enumerable in Object.prototype.&#39;);<tr><td><a id="l345"></a><a href="#l345">345</a><td> }<tr><td><a id="l346"></a><a href="#l346">346</a><td>};<tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td>/**<tr><td><a id="l350"></a><a href="#l350">350</a><td> * Returns the type of a value. If a constructor is passed, and a suitable<tr><td><a id="l351"></a><a href="#l351">351</a><td> * string cannot be found, &#39;unknown type name&#39; will be returned.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @param {*} value A constructor, object, or primitive.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @return {string} The best display name for the value, or &#39;unknown type name&#39;.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @private<tr><td><a id="l355"></a><a href="#l355">355</a><td> */<tr><td><a id="l356"></a><a href="#l356">356</a><td>goog.asserts.getType_ = function(value) {<tr><td><a id="l357"></a><a href="#l357">357</a><td> if (value instanceof Function) {<tr><td><a id="l358"></a><a href="#l358">358</a><td> return value.displayName || value.name || &#39;unknown type name&#39;;<tr><td><a id="l359"></a><a href="#l359">359</a><td> } else if (value instanceof Object) {<tr><td><a id="l360"></a><a href="#l360">360</a><td> return value.constructor.displayName || value.constructor.name ||<tr><td><a id="l361"></a><a href="#l361">361</a><td> Object.prototype.toString.call(value);<tr><td><a id="l362"></a><a href="#l362">362</a><td> } else {<tr><td><a id="l363"></a><a href="#l363">363</a><td> return value === null ? &#39;null&#39; : typeof value;<tr><td><a id="l364"></a><a href="#l364">364</a><td> }<tr><td><a id="l365"></a><a href="#l365">365</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/async/freelist.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>freelist.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/async/freelist.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2015 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 Simple freelist.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * An anterative to goog.structs.SimplePool, it imposes the requirement that the<tr><td><a id="l19"></a><a href="#l19">19</a><td> * objects in the list contain a &quot;next&quot; property that can be used to maintain<tr><td><a id="l20"></a><a href="#l20">20</a><td> * the pool.<tr><td><a id="l21"></a><a href="#l21">21</a><td> */<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.async.FreeList&#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> * @template ITEM<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.async.FreeList = goog.defineClass(null, {<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 {function():ITEM} create<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {function(ITEM):void} reset<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {number} limit<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td> constructor: function(create, reset, limit) {<tr><td><a id="l36"></a><a href="#l36">36</a><td> /** @const {number} */<tr><td><a id="l37"></a><a href="#l37">37</a><td> this.limit_ = limit;<tr><td><a id="l38"></a><a href="#l38">38</a><td> /** @const {function()} */<tr><td><a id="l39"></a><a href="#l39">39</a><td> this.create_ = create;<tr><td><a id="l40"></a><a href="#l40">40</a><td> /** @const {function(ITEM):void} */<tr><td><a id="l41"></a><a href="#l41">41</a><td> this.reset_ = reset;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td> /** @type {number} */<tr><td><a id="l44"></a><a href="#l44">44</a><td> this.occupants_ = 0;<tr><td><a id="l45"></a><a href="#l45">45</a><td> /** @type {ITEM} */<tr><td><a id="l46"></a><a href="#l46">46</a><td> this.head_ = null;<tr><td><a id="l47"></a><a href="#l47">47</a><td> },<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td> /**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {ITEM}<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td> get: function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td> var item;<tr><td><a id="l54"></a><a href="#l54">54</a><td> if (this.occupants_ &gt; 0) {<tr><td><a id="l55"></a><a href="#l55">55</a><td> this.occupants_--;<tr><td><a id="l56"></a><a href="#l56">56</a><td> item = this.head_;<tr><td><a id="l57"></a><a href="#l57">57</a><td> this.head_ = item.next;<tr><td><a id="l58"></a><a href="#l58">58</a><td> item.next = null;<tr><td><a id="l59"></a><a href="#l59">59</a><td> } else {<tr><td><a id="l60"></a><a href="#l60">60</a><td> item = this.create_();<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 item;<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> * @param {ITEM} item An item available for possible future reuse.<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td> put: function(item) {<tr><td><a id="l69"></a><a href="#l69">69</a><td> this.reset_(item);<tr><td><a id="l70"></a><a href="#l70">70</a><td> if (this.occupants_ &lt; this.limit_) {<tr><td><a id="l71"></a><a href="#l71">71</a><td> this.occupants_++;<tr><td><a id="l72"></a><a href="#l72">72</a><td> item.next = this.head_;<tr><td><a id="l73"></a><a href="#l73">73</a><td> this.head_ = item;<tr><td><a id="l74"></a><a href="#l74">74</a><td> }<tr><td><a id="l75"></a><a href="#l75">75</a><td> },<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * Visible for testing.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @package<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @return {number}<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td> occupants: function() {<tr><td><a id="l83"></a><a href="#l83">83</a><td> return this.occupants_;<tr><td><a id="l84"></a><a href="#l84">84</a><td> }<tr><td><a id="l85"></a><a href="#l85">85</a><td>});<tr><td><a id="l86"></a><a href="#l86">86</a><td><tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td></table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/async/nexttick.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>nexttick.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/async/nexttick.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 Provides a function to schedule running a function as soon<tr><td><a id="l17"></a><a href="#l17">17</a><td> * as possible after the current JS execution stops and yields to the event<tr><td><a id="l18"></a><a href="#l18">18</a><td> * loop.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.async.nextTick&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.async.throwException&#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>goog.require(&#39;goog.debug.entryPointRegistry&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.functions&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Throw an item without interrupting the current execution context. For<tr><td><a id="l34"></a><a href="#l34">34</a><td> * example, if processing a group of items in a loop, sometimes it is useful<tr><td><a id="l35"></a><a href="#l35">35</a><td> * to report an error while still allowing the rest of the batch to be<tr><td><a id="l36"></a><a href="#l36">36</a><td> * processed.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {*} exception<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.async.throwException = function(exception) {<tr><td><a id="l40"></a><a href="#l40">40</a><td> // Each throw needs to be in its own context.<tr><td><a id="l41"></a><a href="#l41">41</a><td> goog.global.setTimeout(function() { throw exception; }, 0);<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> * Fires the provided callbacks as soon as possible after the current JS<tr><td><a id="l47"></a><a href="#l47">47</a><td> * execution context. setTimeout(…, 0) takes at least 4ms when called from<tr><td><a id="l48"></a><a href="#l48">48</a><td> * within another setTimeout(…, 0) for legacy reasons.<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * This will not schedule the callback as a microtask (i.e. a task that can<tr><td><a id="l51"></a><a href="#l51">51</a><td> * preempt user input or networking callbacks). It is meant to emulate what<tr><td><a id="l52"></a><a href="#l52">52</a><td> * setTimeout(_, 0) would do if it were not throttled. If you desire microtask<tr><td><a id="l53"></a><a href="#l53">53</a><td> * behavior, use {@see goog.Promise} instead.<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {function(this:SCOPE)} callback Callback function to fire as soon as<tr><td><a id="l56"></a><a href="#l56">56</a><td> * possible.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {SCOPE=} opt_context Object in whose scope to call the listener.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {boolean=} opt_useSetImmediate Avoid the IE workaround that<tr><td><a id="l59"></a><a href="#l59">59</a><td> * ensures correctness at the cost of speed. See comments for details.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @template SCOPE<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.async.nextTick = function(callback, opt_context, opt_useSetImmediate) {<tr><td><a id="l63"></a><a href="#l63">63</a><td> var cb = callback;<tr><td><a id="l64"></a><a href="#l64">64</a><td> if (opt_context) {<tr><td><a id="l65"></a><a href="#l65">65</a><td> cb = goog.bind(callback, opt_context);<tr><td><a id="l66"></a><a href="#l66">66</a><td> }<tr><td><a id="l67"></a><a href="#l67">67</a><td> cb = goog.async.nextTick.wrapCallback_(cb);<tr><td><a id="l68"></a><a href="#l68">68</a><td> // window.setImmediate was introduced and currently only supported by IE10+,<tr><td><a id="l69"></a><a href="#l69">69</a><td> // but due to a bug in the implementation it is not guaranteed that<tr><td><a id="l70"></a><a href="#l70">70</a><td> // setImmediate is faster than setTimeout nor that setImmediate N is before<tr><td><a id="l71"></a><a href="#l71">71</a><td> // setImmediate N+1. That is why we do not use the native version if<tr><td><a id="l72"></a><a href="#l72">72</a><td> // available. We do, however, call setImmediate if it is a normal function<tr><td><a id="l73"></a><a href="#l73">73</a><td> // because that indicates that it has been replaced by goog.testing.MockClock<tr><td><a id="l74"></a><a href="#l74">74</a><td> // which we do want to support.<tr><td><a id="l75"></a><a href="#l75">75</a><td> // See<tr><td><a id="l76"></a><a href="#l76">76</a><td> // http://connect.microsoft.com/IE/feedback/details/801823/setimmediate-and-messagechannel-are-broken-in-ie10<tr><td><a id="l77"></a><a href="#l77">77</a><td> //<tr><td><a id="l78"></a><a href="#l78">78</a><td> // Note we do allow callers to also request setImmediate if they are willing<tr><td><a id="l79"></a><a href="#l79">79</a><td> // to accept the possible tradeoffs of incorrectness in exchange for speed.<tr><td><a id="l80"></a><a href="#l80">80</a><td> // The IE fallback of readystate change is much slower.<tr><td><a id="l81"></a><a href="#l81">81</a><td> if (goog.isFunction(goog.global.setImmediate) &amp;&amp;<tr><td><a id="l82"></a><a href="#l82">82</a><td> // Opt in.<tr><td><a id="l83"></a><a href="#l83">83</a><td> (opt_useSetImmediate ||<tr><td><a id="l84"></a><a href="#l84">84</a><td> // or it isn&#39;t a browser or the environment is weird<tr><td><a id="l85"></a><a href="#l85">85</a><td> !goog.global.Window || !goog.global.Window.prototype ||<tr><td><a id="l86"></a><a href="#l86">86</a><td> // or something redefined setImmediate in which case we (YOLO) decide<tr><td><a id="l87"></a><a href="#l87">87</a><td> // to use it (This is so that we use the mockClock setImmediate. sigh).<tr><td><a id="l88"></a><a href="#l88">88</a><td> goog.global.Window.prototype.setImmediate != goog.global.setImmediate)) {<tr><td><a id="l89"></a><a href="#l89">89</a><td> goog.global.setImmediate(cb);<tr><td><a id="l90"></a><a href="#l90">90</a><td> return;<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> // Look for and cache the custom fallback version of setImmediate.<tr><td><a id="l94"></a><a href="#l94">94</a><td> if (!goog.async.nextTick.setImmediate_) {<tr><td><a id="l95"></a><a href="#l95">95</a><td> goog.async.nextTick.setImmediate_ =<tr><td><a id="l96"></a><a href="#l96">96</a><td> goog.async.nextTick.getSetImmediateEmulator_();<tr><td><a id="l97"></a><a href="#l97">97</a><td> }<tr><td><a id="l98"></a><a href="#l98">98</a><td> goog.async.nextTick.setImmediate_(cb);<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> * Cache for the setImmediate implementation.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @type {function(function())}<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @private<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.async.nextTick.setImmediate_;<tr><td><a id="l108"></a><a href="#l108">108</a><td><tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>/**<tr><td><a id="l111"></a><a href="#l111">111</a><td> * Determines the best possible implementation to run a function as soon as<tr><td><a id="l112"></a><a href="#l112">112</a><td> * the JS event loop is idle.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @return {function(function())} The &quot;setImmediate&quot; implementation.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @private<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.async.nextTick.getSetImmediateEmulator_ = function() {<tr><td><a id="l117"></a><a href="#l117">117</a><td> // Create a private message channel and use it to postMessage empty messages<tr><td><a id="l118"></a><a href="#l118">118</a><td> // to ourselves.<tr><td><a id="l119"></a><a href="#l119">119</a><td> var Channel = goog.global[&#39;MessageChannel&#39;];<tr><td><a id="l120"></a><a href="#l120">120</a><td> // If MessageChannel is not available and we are in a browser, implement<tr><td><a id="l121"></a><a href="#l121">121</a><td> // an iframe based polyfill in browsers that have postMessage and<tr><td><a id="l122"></a><a href="#l122">122</a><td> // document.addEventListener. The latter excludes IE8 because it has a<tr><td><a id="l123"></a><a href="#l123">123</a><td> // synchronous postMessage implementation.<tr><td><a id="l124"></a><a href="#l124">124</a><td> if (typeof Channel === &#39;undefined&#39; &amp;&amp; typeof window !== &#39;undefined&#39; &amp;&amp;<tr><td><a id="l125"></a><a href="#l125">125</a><td> window.postMessage &amp;&amp; window.addEventListener &amp;&amp;<tr><td><a id="l126"></a><a href="#l126">126</a><td> // Presto (The old pre-blink Opera engine) has problems with iframes<tr><td><a id="l127"></a><a href="#l127">127</a><td> // and contentWindow.<tr><td><a id="l128"></a><a href="#l128">128</a><td> !goog.labs.userAgent.engine.isPresto()) {<tr><td><a id="l129"></a><a href="#l129">129</a><td> /** @constructor */<tr><td><a id="l130"></a><a href="#l130">130</a><td> Channel = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td> // Make an empty, invisible iframe.<tr><td><a id="l132"></a><a href="#l132">132</a><td> var iframe = document.createElement(goog.dom.TagName.IFRAME);<tr><td><a id="l133"></a><a href="#l133">133</a><td> iframe.style.display = &#39;none&#39;;<tr><td><a id="l134"></a><a href="#l134">134</a><td> iframe.src = &#39;&#39;;<tr><td><a id="l135"></a><a href="#l135">135</a><td> document.documentElement.appendChild(iframe);<tr><td><a id="l136"></a><a href="#l136">136</a><td> var win = iframe.contentWindow;<tr><td><a id="l137"></a><a href="#l137">137</a><td> var doc = win.document;<tr><td><a id="l138"></a><a href="#l138">138</a><td> doc.open();<tr><td><a id="l139"></a><a href="#l139">139</a><td> doc.write(&#39;&#39;);<tr><td><a id="l140"></a><a href="#l140">140</a><td> doc.close();<tr><td><a id="l141"></a><a href="#l141">141</a><td> // Do not post anything sensitive over this channel, as the workaround for<tr><td><a id="l142"></a><a href="#l142">142</a><td> // pages with file: origin could allow that information to be modified or<tr><td><a id="l143"></a><a href="#l143">143</a><td> // intercepted.<tr><td><a id="l144"></a><a href="#l144">144</a><td> var message = &#39;callImmediate&#39; + Math.random();<tr><td><a id="l145"></a><a href="#l145">145</a><td> // The same origin policy rejects attempts to postMessage from file: urls<tr><td><a id="l146"></a><a href="#l146">146</a><td> // unless the origin is &#39;*&#39;.<tr><td><a id="l147"></a><a href="#l147">147</a><td> // TODO(b/16335441): Use &#39;*&#39; origin for data: and other similar protocols.<tr><td><a id="l148"></a><a href="#l148">148</a><td> var origin = win.location.protocol == &#39;file:&#39; ?<tr><td><a id="l149"></a><a href="#l149">149</a><td> &#39;*&#39; : win.location.protocol + &#39;//&#39; + win.location.host;<tr><td><a id="l150"></a><a href="#l150">150</a><td> var onmessage = goog.bind(function(e) {<tr><td><a id="l151"></a><a href="#l151">151</a><td> // Validate origin and message to make sure that this message was<tr><td><a id="l152"></a><a href="#l152">152</a><td> // intended for us. If the origin is set to &#39;*&#39; (see above) only the<tr><td><a id="l153"></a><a href="#l153">153</a><td> // message needs to match since, for example, &#39;*&#39; != &#39;file://&#39;. Allowing<tr><td><a id="l154"></a><a href="#l154">154</a><td> // the wildcard is ok, as we are not concerned with security here.<tr><td><a id="l155"></a><a href="#l155">155</a><td> if ((origin != &#39;*&#39; &amp;&amp; e.origin != origin) || e.data != message) {<tr><td><a id="l156"></a><a href="#l156">156</a><td> return;<tr><td><a id="l157"></a><a href="#l157">157</a><td> }<tr><td><a id="l158"></a><a href="#l158">158</a><td> this[&#39;port1&#39;].onmessage();<tr><td><a id="l159"></a><a href="#l159">159</a><td> }, this);<tr><td><a id="l160"></a><a href="#l160">160</a><td> win.addEventListener(&#39;message&#39;, onmessage, false);<tr><td><a id="l161"></a><a href="#l161">161</a><td> this[&#39;port1&#39;] = {};<tr><td><a id="l162"></a><a href="#l162">162</a><td> this[&#39;port2&#39;] = {<tr><td><a id="l163"></a><a href="#l163">163</a><td> postMessage: function() {<tr><td><a id="l164"></a><a href="#l164">164</a><td> win.postMessage(message, origin);<tr><td><a id="l165"></a><a href="#l165">165</a><td> }<tr><td><a id="l166"></a><a href="#l166">166</a><td> };<tr><td><a id="l167"></a><a href="#l167">167</a><td> };<tr><td><a id="l168"></a><a href="#l168">168</a><td> }<tr><td><a id="l169"></a><a href="#l169">169</a><td> if (typeof Channel !== &#39;undefined&#39; &amp;&amp;<tr><td><a id="l170"></a><a href="#l170">170</a><td> (!goog.labs.userAgent.browser.isIE())) {<tr><td><a id="l171"></a><a href="#l171">171</a><td> // Exclude all of IE due to<tr><td><a id="l172"></a><a href="#l172">172</a><td> // http://codeforhire.com/2013/09/21/setimmediate-and-messagechannel-broken-on-internet-explorer-10/<tr><td><a id="l173"></a><a href="#l173">173</a><td> // which allows starving postMessage with a busy setTimeout loop.<tr><td><a id="l174"></a><a href="#l174">174</a><td> // This currently affects IE10 and IE11 which would otherwise be able<tr><td><a id="l175"></a><a href="#l175">175</a><td> // to use the postMessage based fallbacks.<tr><td><a id="l176"></a><a href="#l176">176</a><td> var channel = new Channel();<tr><td><a id="l177"></a><a href="#l177">177</a><td> // Use a fifo linked list to call callbacks in the right order.<tr><td><a id="l178"></a><a href="#l178">178</a><td> var head = {};<tr><td><a id="l179"></a><a href="#l179">179</a><td> var tail = head;<tr><td><a id="l180"></a><a href="#l180">180</a><td> channel[&#39;port1&#39;].onmessage = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td> if (goog.isDef(head.next)) {<tr><td><a id="l182"></a><a href="#l182">182</a><td> head = head.next;<tr><td><a id="l183"></a><a href="#l183">183</a><td> var cb = head.cb;<tr><td><a id="l184"></a><a href="#l184">184</a><td> head.cb = null;<tr><td><a id="l185"></a><a href="#l185">185</a><td> cb();<tr><td><a id="l186"></a><a href="#l186">186</a><td> }<tr><td><a id="l187"></a><a href="#l187">187</a><td> };<tr><td><a id="l188"></a><a href="#l188">188</a><td> return function(cb) {<tr><td><a id="l189"></a><a href="#l189">189</a><td> tail.next = {<tr><td><a id="l190"></a><a href="#l190">190</a><td> cb: cb<tr><td><a id="l191"></a><a href="#l191">191</a><td> };<tr><td><a id="l192"></a><a href="#l192">192</a><td> tail = tail.next;<tr><td><a id="l193"></a><a href="#l193">193</a><td> channel[&#39;port2&#39;].postMessage(0);<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> // Implementation for IE6+: Script elements fire an asynchronous<tr><td><a id="l197"></a><a href="#l197">197</a><td> // onreadystatechange event when inserted into the DOM.<tr><td><a id="l198"></a><a href="#l198">198</a><td> if (typeof document !== &#39;undefined&#39; &amp;&amp; &#39;onreadystatechange&#39; in<tr><td><a id="l199"></a><a href="#l199">199</a><td> document.createElement(goog.dom.TagName.SCRIPT)) {<tr><td><a id="l200"></a><a href="#l200">200</a><td> return function(cb) {<tr><td><a id="l201"></a><a href="#l201">201</a><td> var script = document.createElement(goog.dom.TagName.SCRIPT);<tr><td><a id="l202"></a><a href="#l202">202</a><td> script.onreadystatechange = function() {<tr><td><a id="l203"></a><a href="#l203">203</a><td> // Clean up and call the callback.<tr><td><a id="l204"></a><a href="#l204">204</a><td> script.onreadystatechange = null;<tr><td><a id="l205"></a><a href="#l205">205</a><td> script.parentNode.removeChild(script);<tr><td><a id="l206"></a><a href="#l206">206</a><td> script = null;<tr><td><a id="l207"></a><a href="#l207">207</a><td> cb();<tr><td><a id="l208"></a><a href="#l208">208</a><td> cb = null;<tr><td><a id="l209"></a><a href="#l209">209</a><td> };<tr><td><a id="l210"></a><a href="#l210">210</a><td> document.documentElement.appendChild(script);<tr><td><a id="l211"></a><a href="#l211">211</a><td> };<tr><td><a id="l212"></a><a href="#l212">212</a><td> }<tr><td><a id="l213"></a><a href="#l213">213</a><td> // Fall back to setTimeout with 0. In browsers this creates a delay of 5ms<tr><td><a id="l214"></a><a href="#l214">214</a><td> // or more.<tr><td><a id="l215"></a><a href="#l215">215</a><td> return function(cb) {<tr><td><a id="l216"></a><a href="#l216">216</a><td> goog.global.setTimeout(cb, 0);<tr><td><a id="l217"></a><a href="#l217">217</a><td> };<tr><td><a id="l218"></a><a href="#l218">218</a><td>};<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Helper function that is overrided to protect callbacks with entry point<tr><td><a id="l223"></a><a href="#l223">223</a><td> * monitor if the application monitors entry points.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {function()} callback Callback function to fire as soon as possible.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @return {function()} The wrapped callback.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @private<tr><td><a id="l227"></a><a href="#l227">227</a><td> */<tr><td><a id="l228"></a><a href="#l228">228</a><td>goog.async.nextTick.wrapCallback_ = goog.functions.identity;<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>// Register the callback function as an entry point, so that it can be<tr><td><a id="l232"></a><a href="#l232">232</a><td>// monitored for exception handling, etc. This has to be done in this file<tr><td><a id="l233"></a><a href="#l233">233</a><td>// since it requires special code to handle all browsers.<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.debug.entryPointRegistry.register(<tr><td><a id="l235"></a><a href="#l235">235</a><td> /**<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @param {function(!Function): !Function} transformer The transforming<tr><td><a id="l237"></a><a href="#l237">237</a><td> * function.<tr><td><a id="l238"></a><a href="#l238">238</a><td> */<tr><td><a id="l239"></a><a href="#l239">239</a><td> function(transformer) {<tr><td><a id="l240"></a><a href="#l240">240</a><td> goog.async.nextTick.wrapCallback_ = transformer;<tr><td><a id="l241"></a><a href="#l241">241</a><td> });</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/async/run.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>run.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/async/run.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.async.run&#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>goog.require(&#39;goog.async.WorkQueue&#39;);<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.async.nextTick&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.require(&#39;goog.async.throwException&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.require(&#39;goog.testing.watchers&#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> * Fires the provided callback just before the current callstack unwinds, or as<tr><td><a id="l25"></a><a href="#l25">25</a><td> * soon as possible after the current JS execution context.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {function(this:THIS)} callback<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {THIS=} opt_context Object to use as the &quot;this value&quot; when calling<tr><td><a id="l28"></a><a href="#l28">28</a><td> * the provided function.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @template THIS<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.async.run = function(callback, opt_context) {<tr><td><a id="l32"></a><a href="#l32">32</a><td> if (!goog.async.run.schedule_) {<tr><td><a id="l33"></a><a href="#l33">33</a><td> goog.async.run.initializeRunner_();<tr><td><a id="l34"></a><a href="#l34">34</a><td> }<tr><td><a id="l35"></a><a href="#l35">35</a><td> if (!goog.async.run.workQueueScheduled_) {<tr><td><a id="l36"></a><a href="#l36">36</a><td> // Nothing is currently scheduled, schedule it now.<tr><td><a id="l37"></a><a href="#l37">37</a><td> goog.async.run.schedule_();<tr><td><a id="l38"></a><a href="#l38">38</a><td> goog.async.run.workQueueScheduled_ = true;<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> goog.async.run.workQueue_.add(callback, opt_context);<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> * Initializes the function to use to process the work queue.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @private<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.async.run.initializeRunner_ = function() {<tr><td><a id="l50"></a><a href="#l50">50</a><td> // If native Promises are available in the browser, just schedule the callback<tr><td><a id="l51"></a><a href="#l51">51</a><td> // on a fulfilled promise, which is specified to be async, but as fast as<tr><td><a id="l52"></a><a href="#l52">52</a><td> // possible.<tr><td><a id="l53"></a><a href="#l53">53</a><td> if (goog.global.Promise &amp;&amp; goog.global.Promise.resolve) {<tr><td><a id="l54"></a><a href="#l54">54</a><td> var promise = goog.global.Promise.resolve();<tr><td><a id="l55"></a><a href="#l55">55</a><td> goog.async.run.schedule_ = function() {<tr><td><a id="l56"></a><a href="#l56">56</a><td> promise.then(goog.async.run.processWorkQueue);<tr><td><a id="l57"></a><a href="#l57">57</a><td> };<tr><td><a id="l58"></a><a href="#l58">58</a><td> } else {<tr><td><a id="l59"></a><a href="#l59">59</a><td> goog.async.run.schedule_ = function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td> goog.async.nextTick(goog.async.run.processWorkQueue);<tr><td><a id="l61"></a><a href="#l61">61</a><td> };<tr><td><a id="l62"></a><a href="#l62">62</a><td> }<tr><td><a id="l63"></a><a href="#l63">63</a><td>};<tr><td><a id="l64"></a><a href="#l64">64</a><td><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> * Forces goog.async.run to use nextTick instead of Promise.<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 should only be done in unit tests. It&#39;s useful because MockClock<tr><td><a id="l70"></a><a href="#l70">70</a><td> * replaces nextTick, but not the browser Promise implementation, so it allows<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Promise-based code to be tested with MockClock.<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * However, we also want to run promises if the MockClock is no longer in<tr><td><a id="l74"></a><a href="#l74">74</a><td> * control so we schedule a backup &quot;setTimeout&quot; to the unmocked timeout if<tr><td><a id="l75"></a><a href="#l75">75</a><td> * provided.<tr><td><a id="l76"></a><a href="#l76">76</a><td> *<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {function(function())=} opt_realSetTimeout<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.async.run.forceNextTick = function(opt_realSetTimeout) {<tr><td><a id="l80"></a><a href="#l80">80</a><td> goog.async.run.schedule_ = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td> goog.async.nextTick(goog.async.run.processWorkQueue);<tr><td><a id="l82"></a><a href="#l82">82</a><td> if (opt_realSetTimeout) {<tr><td><a id="l83"></a><a href="#l83">83</a><td> opt_realSetTimeout(goog.async.run.processWorkQueue);<tr><td><a id="l84"></a><a href="#l84">84</a><td> }<tr><td><a id="l85"></a><a href="#l85">85</a><td> };<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * The function used to schedule work asynchronousely.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @private {function()}<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.async.run.schedule_;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/** @private {boolean} */<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/** @private {!goog.async.WorkQueue} */<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.async.run.workQueue_ = new goog.async.WorkQueue();<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>if (goog.DEBUG) {<tr><td><a id="l105"></a><a href="#l105">105</a><td> /**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Reset the work queue.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @private<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td> goog.async.run.resetQueue_ = function() {<tr><td><a id="l110"></a><a href="#l110">110</a><td> goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l111"></a><a href="#l111">111</a><td> goog.async.run.workQueue_ = new goog.async.WorkQueue();<tr><td><a id="l112"></a><a href="#l112">112</a><td> };<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td> // If there is a clock implemenation in use for testing<tr><td><a id="l115"></a><a href="#l115">115</a><td> // and it is reset, reset the queue.<tr><td><a id="l116"></a><a href="#l116">116</a><td> goog.testing.watchers.watchClockReset(goog.async.run.resetQueue_);<tr><td><a id="l117"></a><a href="#l117">117</a><td>}<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * Run any pending goog.async.run work items. This function is not intended<tr><td><a id="l122"></a><a href="#l122">122</a><td> * for general use, but for use by entry point handlers to run items ahead of<tr><td><a id="l123"></a><a href="#l123">123</a><td> * goog.async.nextTick.<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.async.run.processWorkQueue = function() {<tr><td><a id="l126"></a><a href="#l126">126</a><td> // NOTE: additional work queue items may be added while processing.<tr><td><a id="l127"></a><a href="#l127">127</a><td> var item = null;<tr><td><a id="l128"></a><a href="#l128">128</a><td> while (item = goog.async.run.workQueue_.remove()) {<tr><td><a id="l129"></a><a href="#l129">129</a><td> try {<tr><td><a id="l130"></a><a href="#l130">130</a><td> item.fn.call(item.scope);<tr><td><a id="l131"></a><a href="#l131">131</a><td> } catch (e) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> goog.async.throwException(e);<tr><td><a id="l133"></a><a href="#l133">133</a><td> }<tr><td><a id="l134"></a><a href="#l134">134</a><td> goog.async.run.workQueue_.returnUnused(item);<tr><td><a id="l135"></a><a href="#l135">135</a><td> }<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td> // There are no more work items, allow processing to be scheduled again.<tr><td><a id="l138"></a><a href="#l138">138</a><td> goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l139"></a><a href="#l139">139</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/async/workqueue.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>workqueue.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/async/workqueue.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2015 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.async.WorkItem&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td>goog.provide(&#39;goog.async.WorkQueue&#39;);<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.require(&#39;goog.asserts&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.require(&#39;goog.async.FreeList&#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>// TODO(johnlenz): generalize the WorkQueue if this is used by more<tr><td><a id="l23"></a><a href="#l23">23</a><td>// than goog.async.run.<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>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * A low GC workqueue. The key elements of this design:<tr><td><a id="l29"></a><a href="#l29">29</a><td> * - avoids the need for goog.bind or equivalent by carrying scope<tr><td><a id="l30"></a><a href="#l30">30</a><td> * - avoids the need for array reallocation by using a linked list<tr><td><a id="l31"></a><a href="#l31">31</a><td> * - minimizes work entry objects allocation by recycling objects<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @constructor<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @final<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> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.async.WorkQueue = function() {<tr><td><a id="l37"></a><a href="#l37">37</a><td> this.workHead_ = null;<tr><td><a id="l38"></a><a href="#l38">38</a><td> this.workTail_ = null;<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>/** @define {number} The maximum number of entries to keep for recycling. */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.define(&#39;goog.async.WorkQueue.DEFAULT_MAX_UNUSED&#39;, 100);<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>/** @const @private {goog.async.FreeList&lt;goog.async.WorkItem&gt;} */<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.async.WorkQueue.freelist_ = new goog.async.FreeList(<tr><td><a id="l48"></a><a href="#l48">48</a><td> function() {return new goog.async.WorkItem(); },<tr><td><a id="l49"></a><a href="#l49">49</a><td> function(item) {item.reset()},<tr><td><a id="l50"></a><a href="#l50">50</a><td> goog.async.WorkQueue.DEFAULT_MAX_UNUSED);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {function()} fn<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {Object|null|undefined} scope<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.async.WorkQueue.prototype.add = function(fn, scope) {<tr><td><a id="l58"></a><a href="#l58">58</a><td> var item = this.getUnusedItem_();<tr><td><a id="l59"></a><a href="#l59">59</a><td> item.set(fn, scope);<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td> if (this.workTail_) {<tr><td><a id="l62"></a><a href="#l62">62</a><td> this.workTail_.next = item;<tr><td><a id="l63"></a><a href="#l63">63</a><td> this.workTail_ = item;<tr><td><a id="l64"></a><a href="#l64">64</a><td> } else {<tr><td><a id="l65"></a><a href="#l65">65</a><td> goog.asserts.assert(!this.workHead_);<tr><td><a id="l66"></a><a href="#l66">66</a><td> this.workHead_ = item;<tr><td><a id="l67"></a><a href="#l67">67</a><td> this.workTail_ = item;<tr><td><a id="l68"></a><a href="#l68">68</a><td> }<tr><td><a id="l69"></a><a href="#l69">69</a><td>};<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td>/**<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @return {goog.async.WorkItem}<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.async.WorkQueue.prototype.remove = function() {<tr><td><a id="l76"></a><a href="#l76">76</a><td> var item = null;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td> if (this.workHead_) {<tr><td><a id="l79"></a><a href="#l79">79</a><td> item = this.workHead_;<tr><td><a id="l80"></a><a href="#l80">80</a><td> this.workHead_ = this.workHead_.next;<tr><td><a id="l81"></a><a href="#l81">81</a><td> if (!this.workHead_) {<tr><td><a id="l82"></a><a href="#l82">82</a><td> this.workTail_ = 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> item.next = null;<tr><td><a id="l85"></a><a href="#l85">85</a><td> }<tr><td><a id="l86"></a><a href="#l86">86</a><td> return item;<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>/**<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @param {goog.async.WorkItem} item<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.async.WorkQueue.prototype.returnUnused = function(item) {<tr><td><a id="l94"></a><a href="#l94">94</a><td> goog.async.WorkQueue.freelist_.put(item);<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @return {goog.async.WorkItem}<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.async.WorkQueue.prototype.getUnusedItem_ = function() {<tr><td><a id="l103"></a><a href="#l103">103</a><td> return goog.async.WorkQueue.freelist_.get();<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>/**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @constructor<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @final<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @struct<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>goog.async.WorkItem = function() {<tr><td><a id="l114"></a><a href="#l114">114</a><td> /** @type {?function()} */<tr><td><a id="l115"></a><a href="#l115">115</a><td> this.fn = null;<tr><td><a id="l116"></a><a href="#l116">116</a><td> /** @type {Object|null|undefined} */<tr><td><a id="l117"></a><a href="#l117">117</a><td> this.scope = null;<tr><td><a id="l118"></a><a href="#l118">118</a><td> /** @type {?goog.async.WorkItem} */<tr><td><a id="l119"></a><a href="#l119">119</a><td> this.next = null;<tr><td><a id="l120"></a><a href="#l120">120</a><td>};<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>/**<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {function()} fn<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @param {Object|null|undefined} scope<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.async.WorkItem.prototype.set = function(fn, scope) {<tr><td><a id="l128"></a><a href="#l128">128</a><td> this.fn = fn;<tr><td><a id="l129"></a><a href="#l129">129</a><td> this.scope = scope;<tr><td><a id="l130"></a><a href="#l130">130</a><td> this.next = null;<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>/** Reset the work item so they don&#39;t prevent GC before reuse */<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.async.WorkItem.prototype.reset = function() {<tr><td><a id="l136"></a><a href="#l136">136</a><td> this.fn = null;<tr><td><a id="l137"></a><a href="#l137">137</a><td> this.scope = null;<tr><td><a id="l138"></a><a href="#l138">138</a><td> this.next = null;<tr><td><a id="l139"></a><a href="#l139">139</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>