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/promise/promise.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>promise.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/promise/promise.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.Promise&#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.Thenable&#39;);<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>goog.require(&#39;goog.async.run&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;goog.async.throwException&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.promise.Resolver&#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>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Promises provide a result that may be resolved asynchronously. A Promise may<tr><td><a id="l29"></a><a href="#l29">29</a><td> * be resolved by being fulfilled with a fulfillment value, rejected with a<tr><td><a id="l30"></a><a href="#l30">30</a><td> * rejection reason, or blocked by another Promise. A Promise is said to be<tr><td><a id="l31"></a><a href="#l31">31</a><td> * settled if it is either fulfilled or rejected. Once settled, the Promise<tr><td><a id="l32"></a><a href="#l32">32</a><td> * result is immutable.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Promises may represent results of any type, including undefined. Rejection<tr><td><a id="l35"></a><a href="#l35">35</a><td> * reasons are typically Errors, but may also be of any type. Closure Promises<tr><td><a id="l36"></a><a href="#l36">36</a><td> * allow for optional type annotations that enforce that fulfillment values are<tr><td><a id="l37"></a><a href="#l37">37</a><td> * of the appropriate types at compile time.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * The result of a Promise is accessible by calling {@code then} and registering<tr><td><a id="l40"></a><a href="#l40">40</a><td> * {@code onFulfilled} and {@code onRejected} callbacks. Once the Promise<tr><td><a id="l41"></a><a href="#l41">41</a><td> * is settled, the relevant callbacks are invoked with the fulfillment value or<tr><td><a id="l42"></a><a href="#l42">42</a><td> * rejection reason as argument. Callbacks are always invoked in the order they<tr><td><a id="l43"></a><a href="#l43">43</a><td> * were registered, even when additional {@code then} calls are made from inside<tr><td><a id="l44"></a><a href="#l44">44</a><td> * another callback. A callback is always run asynchronously sometime after the<tr><td><a id="l45"></a><a href="#l45">45</a><td> * scope containing the registering {@code then} invocation has returned.<tr><td><a id="l46"></a><a href="#l46">46</a><td> *<tr><td><a id="l47"></a><a href="#l47">47</a><td> * If a Promise is resolved with another Promise, the first Promise will block<tr><td><a id="l48"></a><a href="#l48">48</a><td> * until the second is settled, and then assumes the same result as the second<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Promise. This allows Promises to depend on the results of other Promises,<tr><td><a id="l50"></a><a href="#l50">50</a><td> * linking together multiple asynchronous operations.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * This implementation is compatible with the Promises/A+ specification and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * passes that specification&#39;s conformance test suite. A Closure Promise may be<tr><td><a id="l54"></a><a href="#l54">54</a><td> * resolved with a Promise instance (or sufficiently compatible Promise-like<tr><td><a id="l55"></a><a href="#l55">55</a><td> * object) created by other Promise implementations. From the specification,<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Promise-like objects are known as &quot;Thenables&quot;.<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @see http://promisesaplus.com/<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {function(<tr><td><a id="l61"></a><a href="#l61">61</a><td> * this:RESOLVER_CONTEXT,<tr><td><a id="l62"></a><a href="#l62">62</a><td> * function((TYPE|IThenable&lt;TYPE&gt;|Thenable)=),<tr><td><a id="l63"></a><a href="#l63">63</a><td> * function(*=)): void} resolver<tr><td><a id="l64"></a><a href="#l64">64</a><td> * Initialization function that is invoked immediately with {@code resolve}<tr><td><a id="l65"></a><a href="#l65">65</a><td> * and {@code reject} functions as arguments. The Promise is resolved or<tr><td><a id="l66"></a><a href="#l66">66</a><td> * rejected with the first argument passed to either function.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {RESOLVER_CONTEXT=} opt_context An optional context for executing the<tr><td><a id="l68"></a><a href="#l68">68</a><td> * resolver function. If unspecified, the resolver function will be executed<tr><td><a id="l69"></a><a href="#l69">69</a><td> * in the default scope.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @constructor<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @struct<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @final<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @implements {goog.Thenable&lt;TYPE&gt;}<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @template TYPE,RESOLVER_CONTEXT<tr><td><a id="l75"></a><a href="#l75">75</a><td> */<tr><td><a id="l76"></a><a href="#l76">76</a><td>goog.Promise = function(resolver, opt_context) {<tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * The internal state of this Promise. Either PENDING, FULFILLED, REJECTED, or<tr><td><a id="l79"></a><a href="#l79">79</a><td> * BLOCKED.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private {goog.Promise.State_}<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td> this.state_ = goog.Promise.State_.PENDING;<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td> /**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * The settled result of the Promise. Immutable once set with either a<tr><td><a id="l86"></a><a href="#l86">86</a><td> * fulfillment value or rejection reason.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @private {*}<tr><td><a id="l88"></a><a href="#l88">88</a><td> */<tr><td><a id="l89"></a><a href="#l89">89</a><td> this.result_ = undefined;<tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td> /**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * For Promises created by calling {@code then()}, the originating parent.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @private {goog.Promise}<tr><td><a id="l94"></a><a href="#l94">94</a><td> */<tr><td><a id="l95"></a><a href="#l95">95</a><td> this.parent_ = null;<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td> /**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * The linked list of {@code onFulfilled} and {@code onRejected} callbacks<tr><td><a id="l99"></a><a href="#l99">99</a><td> * added to this Promise by calls to {@code then()}.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private {?goog.Promise.CallbackEntry_}<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td> this.callbackEntries_ = null;<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td> /**<tr><td><a id="l105"></a><a href="#l105">105</a><td> * The tail of the linked list of {@code onFulfilled} and {@code onRejected}<tr><td><a id="l106"></a><a href="#l106">106</a><td> * callbacks added to this Promise by calls to {@code then()}.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @private {?goog.Promise.CallbackEntry_}<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td> this.callbackEntriesTail_ = null;<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td> /**<tr><td><a id="l112"></a><a href="#l112">112</a><td> * Whether the Promise is in the queue of Promises to execute.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @private {boolean}<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td> this.executing_ = false;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td> if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l118"></a><a href="#l118">118</a><td> /**<tr><td><a id="l119"></a><a href="#l119">119</a><td> * A timeout ID used when the {@code UNHANDLED_REJECTION_DELAY} is greater<tr><td><a id="l120"></a><a href="#l120">120</a><td> * than 0 milliseconds. The ID is set when the Promise is rejected, and<tr><td><a id="l121"></a><a href="#l121">121</a><td> * cleared only if an {@code onRejected} callback is invoked for the<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Promise (or one of its descendants) before the delay is exceeded.<tr><td><a id="l123"></a><a href="#l123">123</a><td> *<tr><td><a id="l124"></a><a href="#l124">124</a><td> * If the rejection is not handled before the timeout completes, the<tr><td><a id="l125"></a><a href="#l125">125</a><td> * rejection reason is passed to the unhandled rejection handler.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @private {number}<tr><td><a id="l127"></a><a href="#l127">127</a><td> */<tr><td><a id="l128"></a><a href="#l128">128</a><td> this.unhandledRejectionId_ = 0;<tr><td><a id="l129"></a><a href="#l129">129</a><td> } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l130"></a><a href="#l130">130</a><td> /**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * When the {@code UNHANDLED_REJECTION_DELAY} is set to 0 milliseconds, a<tr><td><a id="l132"></a><a href="#l132">132</a><td> * boolean that is set if the Promise is rejected, and reset to false if an<tr><td><a id="l133"></a><a href="#l133">133</a><td> * {@code onRejected} callback is invoked for the Promise (or one of its<tr><td><a id="l134"></a><a href="#l134">134</a><td> * descendants). If the rejection is not handled before the next timestep,<tr><td><a id="l135"></a><a href="#l135">135</a><td> * the rejection reason is passed to the unhandled rejection handler.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @private {boolean}<tr><td><a id="l137"></a><a href="#l137">137</a><td> */<tr><td><a id="l138"></a><a href="#l138">138</a><td> this.hadUnhandledRejection_ = false;<tr><td><a id="l139"></a><a href="#l139">139</a><td> }<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l142"></a><a href="#l142">142</a><td> /**<tr><td><a id="l143"></a><a href="#l143">143</a><td> * A list of stack trace frames pointing to the locations where this Promise<tr><td><a id="l144"></a><a href="#l144">144</a><td> * was created or had callbacks added to it. Saved to add additional context<tr><td><a id="l145"></a><a href="#l145">145</a><td> * to stack traces when an exception is thrown.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @private {!Array&lt;string&gt;}<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td> this.stack_ = [];<tr><td><a id="l149"></a><a href="#l149">149</a><td> this.addStackTrace_(new Error(&#39;created&#39;));<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td> /**<tr><td><a id="l152"></a><a href="#l152">152</a><td> * Index of the most recently executed stack frame entry.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @private {number}<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td> this.currentStep_ = 0;<tr><td><a id="l156"></a><a href="#l156">156</a><td> }<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td> if (resolver == goog.Promise.RESOLVE_FAST_PATH_) {<tr><td><a id="l159"></a><a href="#l159">159</a><td> // If the special sentinel resolver value is passed (from<tr><td><a id="l160"></a><a href="#l160">160</a><td> // goog.Promise.resolve) we short cut to immediately resolve the promise<tr><td><a id="l161"></a><a href="#l161">161</a><td> // using the value passed as opt_context. Don&#39;t try this at home.<tr><td><a id="l162"></a><a href="#l162">162</a><td> this.resolve_(goog.Promise.State_.FULFILLED, opt_context);<tr><td><a id="l163"></a><a href="#l163">163</a><td> } else {<tr><td><a id="l164"></a><a href="#l164">164</a><td> try {<tr><td><a id="l165"></a><a href="#l165">165</a><td> var self = this;<tr><td><a id="l166"></a><a href="#l166">166</a><td> resolver.call(<tr><td><a id="l167"></a><a href="#l167">167</a><td> opt_context,<tr><td><a id="l168"></a><a href="#l168">168</a><td> function(value) {<tr><td><a id="l169"></a><a href="#l169">169</a><td> self.resolve_(goog.Promise.State_.FULFILLED, value);<tr><td><a id="l170"></a><a href="#l170">170</a><td> },<tr><td><a id="l171"></a><a href="#l171">171</a><td> function(reason) {<tr><td><a id="l172"></a><a href="#l172">172</a><td> if (goog.DEBUG &amp;&amp;<tr><td><a id="l173"></a><a href="#l173">173</a><td> !(reason instanceof goog.Promise.CancellationError)) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> try {<tr><td><a id="l175"></a><a href="#l175">175</a><td> // Promise was rejected. Step up one call frame to see why.<tr><td><a id="l176"></a><a href="#l176">176</a><td> if (reason instanceof Error) {<tr><td><a id="l177"></a><a href="#l177">177</a><td> throw reason;<tr><td><a id="l178"></a><a href="#l178">178</a><td> } else {<tr><td><a id="l179"></a><a href="#l179">179</a><td> throw new Error(&#39;Promise rejected.&#39;);<tr><td><a id="l180"></a><a href="#l180">180</a><td> }<tr><td><a id="l181"></a><a href="#l181">181</a><td> } catch (e) {<tr><td><a id="l182"></a><a href="#l182">182</a><td> // Only thrown so browser dev tools can catch rejections of<tr><td><a id="l183"></a><a href="#l183">183</a><td> // promises when the option to break on caught exceptions is<tr><td><a id="l184"></a><a href="#l184">184</a><td> // activated.<tr><td><a id="l185"></a><a href="#l185">185</a><td> }<tr><td><a id="l186"></a><a href="#l186">186</a><td> }<tr><td><a id="l187"></a><a href="#l187">187</a><td> self.resolve_(goog.Promise.State_.REJECTED, reason);<tr><td><a id="l188"></a><a href="#l188">188</a><td> });<tr><td><a id="l189"></a><a href="#l189">189</a><td> } catch (e) {<tr><td><a id="l190"></a><a href="#l190">190</a><td> this.resolve_(goog.Promise.State_.REJECTED, e);<tr><td><a id="l191"></a><a href="#l191">191</a><td> }<tr><td><a id="l192"></a><a href="#l192">192</a><td> }<tr><td><a id="l193"></a><a href="#l193">193</a><td>};<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>/**<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @define {boolean} Whether traces of {@code then} calls should be included in<tr><td><a id="l198"></a><a href="#l198">198</a><td> * exceptions thrown<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>goog.define(&#39;goog.Promise.LONG_STACK_TRACES&#39;, false);<tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td>/**<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @define {number} The delay in milliseconds before a rejected Promise&#39;s reason<tr><td><a id="l205"></a><a href="#l205">205</a><td> * is passed to the rejection handler. By default, the rejection handler<tr><td><a id="l206"></a><a href="#l206">206</a><td> * rethrows the rejection reason so that it appears in the developer console or<tr><td><a id="l207"></a><a href="#l207">207</a><td> * {@code window.onerror} handler.<tr><td><a id="l208"></a><a href="#l208">208</a><td> *<tr><td><a id="l209"></a><a href="#l209">209</a><td> * Rejections are rethrown as quickly as possible by default. A negative value<tr><td><a id="l210"></a><a href="#l210">210</a><td> * disables rejection handling entirely.<tr><td><a id="l211"></a><a href="#l211">211</a><td> */<tr><td><a id="l212"></a><a href="#l212">212</a><td>goog.define(&#39;goog.Promise.UNHANDLED_REJECTION_DELAY&#39;, 0);<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * The possible internal states for a Promise. These states are not directly<tr><td><a id="l217"></a><a href="#l217">217</a><td> * observable to external callers.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @enum {number}<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @private<tr><td><a id="l220"></a><a href="#l220">220</a><td> */<tr><td><a id="l221"></a><a href="#l221">221</a><td>goog.Promise.State_ = {<tr><td><a id="l222"></a><a href="#l222">222</a><td> /** The Promise is waiting for resolution. */<tr><td><a id="l223"></a><a href="#l223">223</a><td> PENDING: 0,<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td> /** The Promise is blocked waiting for the result of another Thenable. */<tr><td><a id="l226"></a><a href="#l226">226</a><td> BLOCKED: 1,<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td> /** The Promise has been resolved with a fulfillment value. */<tr><td><a id="l229"></a><a href="#l229">229</a><td> FULFILLED: 2,<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td> /** The Promise has been resolved with a rejection reason. */<tr><td><a id="l232"></a><a href="#l232">232</a><td> REJECTED: 3<tr><td><a id="l233"></a><a href="#l233">233</a><td>};<tr><td><a id="l234"></a><a href="#l234">234</a><td><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> * Entries in the callback chain. Each call to {@code then},<tr><td><a id="l239"></a><a href="#l239">239</a><td> * {@code thenCatch}, or {@code thenAlways} creates an entry containing the<tr><td><a id="l240"></a><a href="#l240">240</a><td> * functions that may be invoked once the Promise is settled.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @private @final @struct @constructor<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.Promise.CallbackEntry_ = function() {<tr><td><a id="l245"></a><a href="#l245">245</a><td> /** @type {?goog.Promise} */<tr><td><a id="l246"></a><a href="#l246">246</a><td> this.child = null;<tr><td><a id="l247"></a><a href="#l247">247</a><td> /** @type {Function} */<tr><td><a id="l248"></a><a href="#l248">248</a><td> this.onFulfilled = null;<tr><td><a id="l249"></a><a href="#l249">249</a><td> /** @type {Function} */<tr><td><a id="l250"></a><a href="#l250">250</a><td> this.onRejected = null;<tr><td><a id="l251"></a><a href="#l251">251</a><td> /** @type {?} */<tr><td><a id="l252"></a><a href="#l252">252</a><td> this.context = null;<tr><td><a id="l253"></a><a href="#l253">253</a><td> /** @type {?goog.Promise.CallbackEntry_} */<tr><td><a id="l254"></a><a href="#l254">254</a><td> this.next = null;<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> * A boolean value to indicate this is a &quot;thenAlways&quot; callback entry.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * Unlike a normal &quot;then/thenVoid&quot; a &quot;thenAlways doesn&#39;t participate<tr><td><a id="l259"></a><a href="#l259">259</a><td> * in &quot;cancel&quot; considerations but is simply an observer and requires<tr><td><a id="l260"></a><a href="#l260">260</a><td> * special handling.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @type {boolean}<tr><td><a id="l262"></a><a href="#l262">262</a><td> */<tr><td><a id="l263"></a><a href="#l263">263</a><td> this.always = false;<tr><td><a id="l264"></a><a href="#l264">264</a><td>};<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/** clear the object prior to reuse */<tr><td><a id="l268"></a><a href="#l268">268</a><td>goog.Promise.CallbackEntry_.prototype.reset = function() {<tr><td><a id="l269"></a><a href="#l269">269</a><td> this.child = null;<tr><td><a id="l270"></a><a href="#l270">270</a><td> this.onFulfilled = null;<tr><td><a id="l271"></a><a href="#l271">271</a><td> this.onRejected = null;<tr><td><a id="l272"></a><a href="#l272">272</a><td> this.context = null;<tr><td><a id="l273"></a><a href="#l273">273</a><td> this.always = false;<tr><td><a id="l274"></a><a href="#l274">274</a><td>};<tr><td><a id="l275"></a><a href="#l275">275</a><td><tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @define {number} The number of currently unused objects to keep around for<tr><td><a id="l279"></a><a href="#l279">279</a><td> * reuse.<tr><td><a id="l280"></a><a href="#l280">280</a><td> */<tr><td><a id="l281"></a><a href="#l281">281</a><td>goog.define(&#39;goog.Promise.DEFAULT_MAX_UNUSED&#39;, 100);<tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td>/** @const @private {goog.async.FreeList&lt;!goog.Promise.CallbackEntry_&gt;} */<tr><td><a id="l285"></a><a href="#l285">285</a><td>goog.Promise.freelist_ = new goog.async.FreeList(<tr><td><a id="l286"></a><a href="#l286">286</a><td> function() {<tr><td><a id="l287"></a><a href="#l287">287</a><td> return new goog.Promise.CallbackEntry_();<tr><td><a id="l288"></a><a href="#l288">288</a><td> },<tr><td><a id="l289"></a><a href="#l289">289</a><td> function(item) {<tr><td><a id="l290"></a><a href="#l290">290</a><td> item.reset();<tr><td><a id="l291"></a><a href="#l291">291</a><td> },<tr><td><a id="l292"></a><a href="#l292">292</a><td> goog.Promise.DEFAULT_MAX_UNUSED);<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {Function} onFulfilled<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {Function} onRejected<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {?} context<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @return {!goog.Promise.CallbackEntry_}<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @private<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.Promise.getCallbackEntry_ = function(onFulfilled, onRejected, context) {<tr><td><a id="l303"></a><a href="#l303">303</a><td> var entry = goog.Promise.freelist_.get();<tr><td><a id="l304"></a><a href="#l304">304</a><td> entry.onFulfilled = onFulfilled;<tr><td><a id="l305"></a><a href="#l305">305</a><td> entry.onRejected = onRejected;<tr><td><a id="l306"></a><a href="#l306">306</a><td> entry.context = context;<tr><td><a id="l307"></a><a href="#l307">307</a><td> return entry;<tr><td><a id="l308"></a><a href="#l308">308</a><td>};<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td>/**<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @param {!goog.Promise.CallbackEntry_} entry<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @private<tr><td><a id="l314"></a><a href="#l314">314</a><td> */<tr><td><a id="l315"></a><a href="#l315">315</a><td>goog.Promise.returnEntry_ = function(entry) {<tr><td><a id="l316"></a><a href="#l316">316</a><td> goog.Promise.freelist_.put(entry);<tr><td><a id="l317"></a><a href="#l317">317</a><td>};<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * If this passed as the first argument to the {@link goog.Promise} constructor<tr><td><a id="l322"></a><a href="#l322">322</a><td> * the the opt_context is (against its primary use) used to immediately resolve<tr><td><a id="l323"></a><a href="#l323">323</a><td> * the promise. This is used from {@link goog.Promise.resolve} as an<tr><td><a id="l324"></a><a href="#l324">324</a><td> * optimization to avoid allocating 3 closures that are never really needed.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @private @const {!Function}<tr><td><a id="l326"></a><a href="#l326">326</a><td> */<tr><td><a id="l327"></a><a href="#l327">327</a><td>goog.Promise.RESOLVE_FAST_PATH_ = function() {};<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @param {(TYPE|goog.Thenable&lt;TYPE&gt;|Thenable)=} opt_value<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @return {!goog.Promise&lt;TYPE&gt;} A new Promise that is immediately resolved<tr><td><a id="l333"></a><a href="#l333">333</a><td> * with the given value. If the input value is already a goog.Promise, it<tr><td><a id="l334"></a><a href="#l334">334</a><td> * will be returned immediately without creating a new instance.<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @template TYPE<tr><td><a id="l336"></a><a href="#l336">336</a><td> */<tr><td><a id="l337"></a><a href="#l337">337</a><td>goog.Promise.resolve = function(opt_value) {<tr><td><a id="l338"></a><a href="#l338">338</a><td> if (opt_value instanceof goog.Promise) {<tr><td><a id="l339"></a><a href="#l339">339</a><td> // Avoid creating a new object if we already have a promise object<tr><td><a id="l340"></a><a href="#l340">340</a><td> // of the correct type.<tr><td><a id="l341"></a><a href="#l341">341</a><td> return opt_value;<tr><td><a id="l342"></a><a href="#l342">342</a><td> }<tr><td><a id="l343"></a><a href="#l343">343</a><td><tr><td><a id="l344"></a><a href="#l344">344</a><td> // Passes the value as the context, which is a special fast pass when<tr><td><a id="l345"></a><a href="#l345">345</a><td> // goog.Promise.RESOLVE_FAST_PATH_ is passed as the first argument.<tr><td><a id="l346"></a><a href="#l346">346</a><td> return new goog.Promise(goog.Promise.RESOLVE_FAST_PATH_, opt_value);<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>/**<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @param {*=} opt_reason<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @return {!goog.Promise} A new Promise that is immediately rejected with the<tr><td><a id="l353"></a><a href="#l353">353</a><td> * given reason.<tr><td><a id="l354"></a><a href="#l354">354</a><td> */<tr><td><a id="l355"></a><a href="#l355">355</a><td>goog.Promise.reject = function(opt_reason) {<tr><td><a id="l356"></a><a href="#l356">356</a><td> return new goog.Promise(function(resolve, reject) {<tr><td><a id="l357"></a><a href="#l357">357</a><td> reject(opt_reason);<tr><td><a id="l358"></a><a href="#l358">358</a><td> });<tr><td><a id="l359"></a><a href="#l359">359</a><td>};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td>/**<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @param {!Array&lt;!(goog.Thenable&lt;TYPE&gt;|Thenable)&gt;} promises<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {!goog.Promise&lt;TYPE&gt;} A Promise that receives the result of the<tr><td><a id="l365"></a><a href="#l365">365</a><td> * first Promise (or Promise-like) input to settle immediately after it<tr><td><a id="l366"></a><a href="#l366">366</a><td> * settles.<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @template TYPE<tr><td><a id="l368"></a><a href="#l368">368</a><td> */<tr><td><a id="l369"></a><a href="#l369">369</a><td>goog.Promise.race = function(promises) {<tr><td><a id="l370"></a><a href="#l370">370</a><td> return new goog.Promise(function(resolve, reject) {<tr><td><a id="l371"></a><a href="#l371">371</a><td> if (!promises.length) {<tr><td><a id="l372"></a><a href="#l372">372</a><td> resolve(undefined);<tr><td><a id="l373"></a><a href="#l373">373</a><td> }<tr><td><a id="l374"></a><a href="#l374">374</a><td> for (var i = 0, promise; promise = promises[i]; i++) {<tr><td><a id="l375"></a><a href="#l375">375</a><td> goog.Promise.maybeThenVoid_(promise, resolve, reject);<tr><td><a id="l376"></a><a href="#l376">376</a><td> }<tr><td><a id="l377"></a><a href="#l377">377</a><td> });<tr><td><a id="l378"></a><a href="#l378">378</a><td>};<tr><td><a id="l379"></a><a href="#l379">379</a><td><tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td>/**<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {!Array&lt;!(goog.Thenable&lt;TYPE&gt;|Thenable)&gt;} promises<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {!goog.Promise&lt;!Array&lt;TYPE&gt;&gt;} A Promise that receives a list of<tr><td><a id="l384"></a><a href="#l384">384</a><td> * every fulfilled value once every input Promise (or Promise-like) is<tr><td><a id="l385"></a><a href="#l385">385</a><td> * successfully fulfilled, or is rejected with the first rejection reason<tr><td><a id="l386"></a><a href="#l386">386</a><td> * immediately after it is rejected.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @template TYPE<tr><td><a id="l388"></a><a href="#l388">388</a><td> */<tr><td><a id="l389"></a><a href="#l389">389</a><td>goog.Promise.all = function(promises) {<tr><td><a id="l390"></a><a href="#l390">390</a><td> return new goog.Promise(function(resolve, reject) {<tr><td><a id="l391"></a><a href="#l391">391</a><td> var toFulfill = promises.length;<tr><td><a id="l392"></a><a href="#l392">392</a><td> var values = [];<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td> if (!toFulfill) {<tr><td><a id="l395"></a><a href="#l395">395</a><td> resolve(values);<tr><td><a id="l396"></a><a href="#l396">396</a><td> return;<tr><td><a id="l397"></a><a href="#l397">397</a><td> }<tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td> var onFulfill = function(index, value) {<tr><td><a id="l400"></a><a href="#l400">400</a><td> toFulfill--;<tr><td><a id="l401"></a><a href="#l401">401</a><td> values[index] = value;<tr><td><a id="l402"></a><a href="#l402">402</a><td> if (toFulfill == 0) {<tr><td><a id="l403"></a><a href="#l403">403</a><td> resolve(values);<tr><td><a id="l404"></a><a href="#l404">404</a><td> }<tr><td><a id="l405"></a><a href="#l405">405</a><td> };<tr><td><a id="l406"></a><a href="#l406">406</a><td><tr><td><a id="l407"></a><a href="#l407">407</a><td> var onReject = function(reason) {<tr><td><a id="l408"></a><a href="#l408">408</a><td> reject(reason);<tr><td><a id="l409"></a><a href="#l409">409</a><td> };<tr><td><a id="l410"></a><a href="#l410">410</a><td><tr><td><a id="l411"></a><a href="#l411">411</a><td> for (var i = 0, promise; promise = promises[i]; i++) {<tr><td><a id="l412"></a><a href="#l412">412</a><td> goog.Promise.maybeThenVoid_(<tr><td><a id="l413"></a><a href="#l413">413</a><td> promise, goog.partial(onFulfill, i), onReject);<tr><td><a id="l414"></a><a href="#l414">414</a><td> }<tr><td><a id="l415"></a><a href="#l415">415</a><td> });<tr><td><a id="l416"></a><a href="#l416">416</a><td>};<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td><tr><td><a id="l419"></a><a href="#l419">419</a><td>/**<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {!Array&lt;!(goog.Thenable&lt;TYPE&gt;|Thenable)&gt;} promises<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @return {!goog.Promise&lt;!Array&lt;{<tr><td><a id="l422"></a><a href="#l422">422</a><td> * fulfilled: boolean,<tr><td><a id="l423"></a><a href="#l423">423</a><td> * value: (TYPE|undefined),<tr><td><a id="l424"></a><a href="#l424">424</a><td> * reason: (*|undefined)}&gt;&gt;} A Promise that resolves with a list of<tr><td><a id="l425"></a><a href="#l425">425</a><td> * result objects once all input Promises (or Promise-like) have<tr><td><a id="l426"></a><a href="#l426">426</a><td> * settled. Each result object contains a &#39;fulfilled&#39; boolean indicating<tr><td><a id="l427"></a><a href="#l427">427</a><td> * whether an input Promise was fulfilled or rejected. For fulfilled<tr><td><a id="l428"></a><a href="#l428">428</a><td> * Promises, the resulting value is stored in the &#39;value&#39; field. For<tr><td><a id="l429"></a><a href="#l429">429</a><td> * rejected Promises, the rejection reason is stored in the &#39;reason&#39;<tr><td><a id="l430"></a><a href="#l430">430</a><td> * field.<tr><td><a id="l431"></a><a href="#l431">431</a><td> * @template TYPE<tr><td><a id="l432"></a><a href="#l432">432</a><td> */<tr><td><a id="l433"></a><a href="#l433">433</a><td>goog.Promise.allSettled = function(promises) {<tr><td><a id="l434"></a><a href="#l434">434</a><td> return new goog.Promise(function(resolve, reject) {<tr><td><a id="l435"></a><a href="#l435">435</a><td> var toSettle = promises.length;<tr><td><a id="l436"></a><a href="#l436">436</a><td> var results = [];<tr><td><a id="l437"></a><a href="#l437">437</a><td><tr><td><a id="l438"></a><a href="#l438">438</a><td> if (!toSettle) {<tr><td><a id="l439"></a><a href="#l439">439</a><td> resolve(results);<tr><td><a id="l440"></a><a href="#l440">440</a><td> return;<tr><td><a id="l441"></a><a href="#l441">441</a><td> }<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td> var onSettled = function(index, fulfilled, result) {<tr><td><a id="l444"></a><a href="#l444">444</a><td> toSettle--;<tr><td><a id="l445"></a><a href="#l445">445</a><td> results[index] = fulfilled ?<tr><td><a id="l446"></a><a href="#l446">446</a><td> {fulfilled: true, value: result} :<tr><td><a id="l447"></a><a href="#l447">447</a><td> {fulfilled: false, reason: result};<tr><td><a id="l448"></a><a href="#l448">448</a><td> if (toSettle == 0) {<tr><td><a id="l449"></a><a href="#l449">449</a><td> resolve(results);<tr><td><a id="l450"></a><a href="#l450">450</a><td> }<tr><td><a id="l451"></a><a href="#l451">451</a><td> };<tr><td><a id="l452"></a><a href="#l452">452</a><td><tr><td><a id="l453"></a><a href="#l453">453</a><td> for (var i = 0, promise; promise = promises[i]; i++) {<tr><td><a id="l454"></a><a href="#l454">454</a><td> goog.Promise.maybeThenVoid_(promise,<tr><td><a id="l455"></a><a href="#l455">455</a><td> goog.partial(onSettled, i, true /* fulfilled */),<tr><td><a id="l456"></a><a href="#l456">456</a><td> goog.partial(onSettled, i, false /* fulfilled */));<tr><td><a id="l457"></a><a href="#l457">457</a><td> }<tr><td><a id="l458"></a><a href="#l458">458</a><td> });<tr><td><a id="l459"></a><a href="#l459">459</a><td>};<tr><td><a id="l460"></a><a href="#l460">460</a><td><tr><td><a id="l461"></a><a href="#l461">461</a><td><tr><td><a id="l462"></a><a href="#l462">462</a><td>/**<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {!Array&lt;!(goog.Thenable&lt;TYPE&gt;|Thenable)&gt;} promises<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @return {!goog.Promise&lt;TYPE&gt;} A Promise that receives the value of the first<tr><td><a id="l465"></a><a href="#l465">465</a><td> * input to be fulfilled, or is rejected with a list of every rejection<tr><td><a id="l466"></a><a href="#l466">466</a><td> * reason if all inputs are rejected.<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @template TYPE<tr><td><a id="l468"></a><a href="#l468">468</a><td> */<tr><td><a id="l469"></a><a href="#l469">469</a><td>goog.Promise.firstFulfilled = function(promises) {<tr><td><a id="l470"></a><a href="#l470">470</a><td> return new goog.Promise(function(resolve, reject) {<tr><td><a id="l471"></a><a href="#l471">471</a><td> var toReject = promises.length;<tr><td><a id="l472"></a><a href="#l472">472</a><td> var reasons = [];<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td> if (!toReject) {<tr><td><a id="l475"></a><a href="#l475">475</a><td> resolve(undefined);<tr><td><a id="l476"></a><a href="#l476">476</a><td> return;<tr><td><a id="l477"></a><a href="#l477">477</a><td> }<tr><td><a id="l478"></a><a href="#l478">478</a><td><tr><td><a id="l479"></a><a href="#l479">479</a><td> var onFulfill = function(value) {<tr><td><a id="l480"></a><a href="#l480">480</a><td> resolve(value);<tr><td><a id="l481"></a><a href="#l481">481</a><td> };<tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td> var onReject = function(index, reason) {<tr><td><a id="l484"></a><a href="#l484">484</a><td> toReject--;<tr><td><a id="l485"></a><a href="#l485">485</a><td> reasons[index] = reason;<tr><td><a id="l486"></a><a href="#l486">486</a><td> if (toReject == 0) {<tr><td><a id="l487"></a><a href="#l487">487</a><td> reject(reasons);<tr><td><a id="l488"></a><a href="#l488">488</a><td> }<tr><td><a id="l489"></a><a href="#l489">489</a><td> };<tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td> for (var i = 0, promise; promise = promises[i]; i++) {<tr><td><a id="l492"></a><a href="#l492">492</a><td> goog.Promise.maybeThenVoid_(<tr><td><a id="l493"></a><a href="#l493">493</a><td> promise, onFulfill, goog.partial(onReject, i));<tr><td><a id="l494"></a><a href="#l494">494</a><td> }<tr><td><a id="l495"></a><a href="#l495">495</a><td> });<tr><td><a id="l496"></a><a href="#l496">496</a><td>};<tr><td><a id="l497"></a><a href="#l497">497</a><td><tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td>/**<tr><td><a id="l500"></a><a href="#l500">500</a><td> * @return {!goog.promise.Resolver&lt;TYPE&gt;} Resolver wrapping the promise and its<tr><td><a id="l501"></a><a href="#l501">501</a><td> * resolve / reject functions. Resolving or rejecting the resolver<tr><td><a id="l502"></a><a href="#l502">502</a><td> * resolves or rejects the promise.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @template TYPE<tr><td><a id="l504"></a><a href="#l504">504</a><td> */<tr><td><a id="l505"></a><a href="#l505">505</a><td>goog.Promise.withResolver = function() {<tr><td><a id="l506"></a><a href="#l506">506</a><td> var resolve, reject;<tr><td><a id="l507"></a><a href="#l507">507</a><td> var promise = new goog.Promise(function(rs, rj) {<tr><td><a id="l508"></a><a href="#l508">508</a><td> resolve = rs;<tr><td><a id="l509"></a><a href="#l509">509</a><td> reject = rj;<tr><td><a id="l510"></a><a href="#l510">510</a><td> });<tr><td><a id="l511"></a><a href="#l511">511</a><td> return new goog.Promise.Resolver_(promise, resolve, reject);<tr><td><a id="l512"></a><a href="#l512">512</a><td>};<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td><tr><td><a id="l515"></a><a href="#l515">515</a><td>/**<tr><td><a id="l516"></a><a href="#l516">516</a><td> * Adds callbacks that will operate on the result of the Promise, returning a<tr><td><a id="l517"></a><a href="#l517">517</a><td> * new child Promise.<tr><td><a id="l518"></a><a href="#l518">518</a><td> *<tr><td><a id="l519"></a><a href="#l519">519</a><td> * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked<tr><td><a id="l520"></a><a href="#l520">520</a><td> * with the fulfillment value as argument, and the child Promise will be<tr><td><a id="l521"></a><a href="#l521">521</a><td> * fulfilled with the return value of the callback. If the callback throws an<tr><td><a id="l522"></a><a href="#l522">522</a><td> * exception, the child Promise will be rejected with the thrown value instead.<tr><td><a id="l523"></a><a href="#l523">523</a><td> *<tr><td><a id="l524"></a><a href="#l524">524</a><td> * If the Promise is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l525"></a><a href="#l525">525</a><td> * with the rejection reason as argument, and the child Promise will be resolved<tr><td><a id="l526"></a><a href="#l526">526</a><td> * with the return value or rejected with the thrown value of the callback.<tr><td><a id="l527"></a><a href="#l527">527</a><td> *<tr><td><a id="l528"></a><a href="#l528">528</a><td> * @override<tr><td><a id="l529"></a><a href="#l529">529</a><td> */<tr><td><a id="l530"></a><a href="#l530">530</a><td>goog.Promise.prototype.then = function(<tr><td><a id="l531"></a><a href="#l531">531</a><td> opt_onFulfilled, opt_onRejected, opt_context) {<tr><td><a id="l532"></a><a href="#l532">532</a><td><tr><td><a id="l533"></a><a href="#l533">533</a><td> if (opt_onFulfilled != null) {<tr><td><a id="l534"></a><a href="#l534">534</a><td> goog.asserts.assertFunction(opt_onFulfilled,<tr><td><a id="l535"></a><a href="#l535">535</a><td> &#39;opt_onFulfilled should be a function.&#39;);<tr><td><a id="l536"></a><a href="#l536">536</a><td> }<tr><td><a id="l537"></a><a href="#l537">537</a><td> if (opt_onRejected != null) {<tr><td><a id="l538"></a><a href="#l538">538</a><td> goog.asserts.assertFunction(opt_onRejected,<tr><td><a id="l539"></a><a href="#l539">539</a><td> &#39;opt_onRejected should be a function. Did you pass opt_context &#39; +<tr><td><a id="l540"></a><a href="#l540">540</a><td> &#39;as the second argument instead of the third?&#39;);<tr><td><a id="l541"></a><a href="#l541">541</a><td> }<tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l544"></a><a href="#l544">544</a><td> this.addStackTrace_(new Error(&#39;then&#39;));<tr><td><a id="l545"></a><a href="#l545">545</a><td> }<tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td> return this.addChildPromise_(<tr><td><a id="l548"></a><a href="#l548">548</a><td> goog.isFunction(opt_onFulfilled) ? opt_onFulfilled : null,<tr><td><a id="l549"></a><a href="#l549">549</a><td> goog.isFunction(opt_onRejected) ? opt_onRejected : null,<tr><td><a id="l550"></a><a href="#l550">550</a><td> opt_context);<tr><td><a id="l551"></a><a href="#l551">551</a><td>};<tr><td><a id="l552"></a><a href="#l552">552</a><td>goog.Thenable.addImplementation(goog.Promise);<tr><td><a id="l553"></a><a href="#l553">553</a><td><tr><td><a id="l554"></a><a href="#l554">554</a><td><tr><td><a id="l555"></a><a href="#l555">555</a><td>/**<tr><td><a id="l556"></a><a href="#l556">556</a><td> * Adds callbacks that will operate on the result of the Promise without<tr><td><a id="l557"></a><a href="#l557">557</a><td> * returning a child Promise (unlike &quot;then&quot;).<tr><td><a id="l558"></a><a href="#l558">558</a><td> *<tr><td><a id="l559"></a><a href="#l559">559</a><td> * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked<tr><td><a id="l560"></a><a href="#l560">560</a><td> * with the fulfillment value as argument.<tr><td><a id="l561"></a><a href="#l561">561</a><td> *<tr><td><a id="l562"></a><a href="#l562">562</a><td> * If the Promise is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l563"></a><a href="#l563">563</a><td> * with the rejection reason as argument.<tr><td><a id="l564"></a><a href="#l564">564</a><td> *<tr><td><a id="l565"></a><a href="#l565">565</a><td> * @param {?(function(this:THIS, TYPE):?)=} opt_onFulfilled A<tr><td><a id="l566"></a><a href="#l566">566</a><td> * function that will be invoked with the fulfillment value if the Promise<tr><td><a id="l567"></a><a href="#l567">567</a><td> * is fulfilled.<tr><td><a id="l568"></a><a href="#l568">568</a><td> * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will<tr><td><a id="l569"></a><a href="#l569">569</a><td> * be invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l570"></a><a href="#l570">570</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l571"></a><a href="#l571">571</a><td> * execution context for the callbacks. By default, functions are executed<tr><td><a id="l572"></a><a href="#l572">572</a><td> * with the default this.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @package<tr><td><a id="l574"></a><a href="#l574">574</a><td> * @template THIS<tr><td><a id="l575"></a><a href="#l575">575</a><td> */<tr><td><a id="l576"></a><a href="#l576">576</a><td>goog.Promise.prototype.thenVoid = function(<tr><td><a id="l577"></a><a href="#l577">577</a><td> opt_onFulfilled, opt_onRejected, opt_context) {<tr><td><a id="l578"></a><a href="#l578">578</a><td><tr><td><a id="l579"></a><a href="#l579">579</a><td> if (opt_onFulfilled != null) {<tr><td><a id="l580"></a><a href="#l580">580</a><td> goog.asserts.assertFunction(opt_onFulfilled,<tr><td><a id="l581"></a><a href="#l581">581</a><td> &#39;opt_onFulfilled should be a function.&#39;);<tr><td><a id="l582"></a><a href="#l582">582</a><td> }<tr><td><a id="l583"></a><a href="#l583">583</a><td> if (opt_onRejected != null) {<tr><td><a id="l584"></a><a href="#l584">584</a><td> goog.asserts.assertFunction(opt_onRejected,<tr><td><a id="l585"></a><a href="#l585">585</a><td> &#39;opt_onRejected should be a function. Did you pass opt_context &#39; +<tr><td><a id="l586"></a><a href="#l586">586</a><td> &#39;as the second argument instead of the third?&#39;);<tr><td><a id="l587"></a><a href="#l587">587</a><td> }<tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l590"></a><a href="#l590">590</a><td> this.addStackTrace_(new Error(&#39;then&#39;));<tr><td><a id="l591"></a><a href="#l591">591</a><td> }<tr><td><a id="l592"></a><a href="#l592">592</a><td><tr><td><a id="l593"></a><a href="#l593">593</a><td> // Note: no default rejection handler is provided here as we need to<tr><td><a id="l594"></a><a href="#l594">594</a><td> // distinguish unhandled rejections.<tr><td><a id="l595"></a><a href="#l595">595</a><td> this.addCallbackEntry_(goog.Promise.getCallbackEntry_(<tr><td><a id="l596"></a><a href="#l596">596</a><td> opt_onFulfilled || goog.nullFunction,<tr><td><a id="l597"></a><a href="#l597">597</a><td> opt_onRejected || null,<tr><td><a id="l598"></a><a href="#l598">598</a><td> opt_context));<tr><td><a id="l599"></a><a href="#l599">599</a><td>};<tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td><tr><td><a id="l602"></a><a href="#l602">602</a><td>/**<tr><td><a id="l603"></a><a href="#l603">603</a><td> * Calls &quot;thenVoid&quot; if possible to avoid allocating memory. Otherwise calls<tr><td><a id="l604"></a><a href="#l604">604</a><td> * &quot;then&quot;.<tr><td><a id="l605"></a><a href="#l605">605</a><td> * @param {(goog.Thenable&lt;TYPE&gt;|Thenable)} promise<tr><td><a id="l606"></a><a href="#l606">606</a><td> * @param {function(this:THIS, TYPE): ?} onFulfilled<tr><td><a id="l607"></a><a href="#l607">607</a><td> * @param {function(this:THIS, *): *} onRejected<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @param {THIS=} opt_context<tr><td><a id="l609"></a><a href="#l609">609</a><td> * @template THIS,TYPE<tr><td><a id="l610"></a><a href="#l610">610</a><td> * @private<tr><td><a id="l611"></a><a href="#l611">611</a><td> */<tr><td><a id="l612"></a><a href="#l612">612</a><td>goog.Promise.maybeThenVoid_ = function(<tr><td><a id="l613"></a><a href="#l613">613</a><td> promise, onFulfilled, onRejected, opt_context) {<tr><td><a id="l614"></a><a href="#l614">614</a><td> if (promise instanceof goog.Promise) {<tr><td><a id="l615"></a><a href="#l615">615</a><td> promise.thenVoid(onFulfilled, onRejected, opt_context);<tr><td><a id="l616"></a><a href="#l616">616</a><td> } else {<tr><td><a id="l617"></a><a href="#l617">617</a><td> promise.then(onFulfilled, onRejected, opt_context);<tr><td><a id="l618"></a><a href="#l618">618</a><td> }<tr><td><a id="l619"></a><a href="#l619">619</a><td>};<tr><td><a id="l620"></a><a href="#l620">620</a><td><tr><td><a id="l621"></a><a href="#l621">621</a><td><tr><td><a id="l622"></a><a href="#l622">622</a><td>/**<tr><td><a id="l623"></a><a href="#l623">623</a><td> * Adds a callback that will be invoked when the Promise is settled (fulfilled<tr><td><a id="l624"></a><a href="#l624">624</a><td> * or rejected). The callback receives no argument, and no new child Promise is<tr><td><a id="l625"></a><a href="#l625">625</a><td> * created. This is useful for ensuring that cleanup takes place after certain<tr><td><a id="l626"></a><a href="#l626">626</a><td> * asynchronous operations. Callbacks added with {@code thenAlways} will be<tr><td><a id="l627"></a><a href="#l627">627</a><td> * executed in the same order with other calls to {@code then},<tr><td><a id="l628"></a><a href="#l628">628</a><td> * {@code thenAlways}, or {@code thenCatch}.<tr><td><a id="l629"></a><a href="#l629">629</a><td> *<tr><td><a id="l630"></a><a href="#l630">630</a><td> * Since it does not produce a new child Promise, cancellation propagation is<tr><td><a id="l631"></a><a href="#l631">631</a><td> * not prevented by adding callbacks with {@code thenAlways}. A Promise that has<tr><td><a id="l632"></a><a href="#l632">632</a><td> * a cleanup handler added with {@code thenAlways} will be canceled if all of<tr><td><a id="l633"></a><a href="#l633">633</a><td> * its children created by {@code then} (or {@code thenCatch}) are canceled.<tr><td><a id="l634"></a><a href="#l634">634</a><td> * Additionally, since any rejections are not passed to the callback, it does<tr><td><a id="l635"></a><a href="#l635">635</a><td> * not stop the unhandled rejection handler from running.<tr><td><a id="l636"></a><a href="#l636">636</a><td> *<tr><td><a id="l637"></a><a href="#l637">637</a><td> * @param {function(this:THIS): void} onSettled A function that will be invoked<tr><td><a id="l638"></a><a href="#l638">638</a><td> * when the Promise is settled (fulfilled or rejected).<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l640"></a><a href="#l640">640</a><td> * execution context for the callbacks. By default, functions are executed<tr><td><a id="l641"></a><a href="#l641">641</a><td> * in the global scope.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {!goog.Promise&lt;TYPE&gt;} This Promise, for chaining additional calls.<tr><td><a id="l643"></a><a href="#l643">643</a><td> * @template THIS<tr><td><a id="l644"></a><a href="#l644">644</a><td> */<tr><td><a id="l645"></a><a href="#l645">645</a><td>goog.Promise.prototype.thenAlways = function(onSettled, opt_context) {<tr><td><a id="l646"></a><a href="#l646">646</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l647"></a><a href="#l647">647</a><td> this.addStackTrace_(new Error(&#39;thenAlways&#39;));<tr><td><a id="l648"></a><a href="#l648">648</a><td> }<tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td> var entry = goog.Promise.getCallbackEntry_(onSettled, onSettled, opt_context);<tr><td><a id="l651"></a><a href="#l651">651</a><td> entry.always = true;<tr><td><a id="l652"></a><a href="#l652">652</a><td> this.addCallbackEntry_(entry);<tr><td><a id="l653"></a><a href="#l653">653</a><td> return this;<tr><td><a id="l654"></a><a href="#l654">654</a><td>};<tr><td><a id="l655"></a><a href="#l655">655</a><td><tr><td><a id="l656"></a><a href="#l656">656</a><td><tr><td><a id="l657"></a><a href="#l657">657</a><td>/**<tr><td><a id="l658"></a><a href="#l658">658</a><td> * Adds a callback that will be invoked only if the Promise is rejected. This<tr><td><a id="l659"></a><a href="#l659">659</a><td> * is equivalent to {@code then(null, onRejected)}.<tr><td><a id="l660"></a><a href="#l660">660</a><td> *<tr><td><a id="l661"></a><a href="#l661">661</a><td> * @param {!function(this:THIS, *): *} onRejected A function that will be<tr><td><a id="l662"></a><a href="#l662">662</a><td> * invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l664"></a><a href="#l664">664</a><td> * execution context for the callbacks. By default, functions are executed<tr><td><a id="l665"></a><a href="#l665">665</a><td> * in the global scope.<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @return {!goog.Promise} A new Promise that will receive the result of the<tr><td><a id="l667"></a><a href="#l667">667</a><td> * callback.<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @template THIS<tr><td><a id="l669"></a><a href="#l669">669</a><td> */<tr><td><a id="l670"></a><a href="#l670">670</a><td>goog.Promise.prototype.thenCatch = function(onRejected, opt_context) {<tr><td><a id="l671"></a><a href="#l671">671</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l672"></a><a href="#l672">672</a><td> this.addStackTrace_(new Error(&#39;thenCatch&#39;));<tr><td><a id="l673"></a><a href="#l673">673</a><td> }<tr><td><a id="l674"></a><a href="#l674">674</a><td> return this.addChildPromise_(null, onRejected, opt_context);<tr><td><a id="l675"></a><a href="#l675">675</a><td>};<tr><td><a id="l676"></a><a href="#l676">676</a><td><tr><td><a id="l677"></a><a href="#l677">677</a><td><tr><td><a id="l678"></a><a href="#l678">678</a><td>/**<tr><td><a id="l679"></a><a href="#l679">679</a><td> * Cancels the Promise if it is still pending by rejecting it with a cancel<tr><td><a id="l680"></a><a href="#l680">680</a><td> * Error. No action is performed if the Promise is already resolved.<tr><td><a id="l681"></a><a href="#l681">681</a><td> *<tr><td><a id="l682"></a><a href="#l682">682</a><td> * All child Promises of the canceled Promise will be rejected with the same<tr><td><a id="l683"></a><a href="#l683">683</a><td> * cancel error, as with normal Promise rejection. If the Promise to be canceled<tr><td><a id="l684"></a><a href="#l684">684</a><td> * is the only child of a pending Promise, the parent Promise will also be<tr><td><a id="l685"></a><a href="#l685">685</a><td> * canceled. Cancellation may propagate upward through multiple generations.<tr><td><a id="l686"></a><a href="#l686">686</a><td> *<tr><td><a id="l687"></a><a href="#l687">687</a><td> * @param {string=} opt_message An optional debugging message for describing the<tr><td><a id="l688"></a><a href="#l688">688</a><td> * cancellation reason.<tr><td><a id="l689"></a><a href="#l689">689</a><td> */<tr><td><a id="l690"></a><a href="#l690">690</a><td>goog.Promise.prototype.cancel = function(opt_message) {<tr><td><a id="l691"></a><a href="#l691">691</a><td> if (this.state_ == goog.Promise.State_.PENDING) {<tr><td><a id="l692"></a><a href="#l692">692</a><td> goog.async.run(function() {<tr><td><a id="l693"></a><a href="#l693">693</a><td> var err = new goog.Promise.CancellationError(opt_message);<tr><td><a id="l694"></a><a href="#l694">694</a><td> this.cancelInternal_(err);<tr><td><a id="l695"></a><a href="#l695">695</a><td> }, this);<tr><td><a id="l696"></a><a href="#l696">696</a><td> }<tr><td><a id="l697"></a><a href="#l697">697</a><td>};<tr><td><a id="l698"></a><a href="#l698">698</a><td><tr><td><a id="l699"></a><a href="#l699">699</a><td><tr><td><a id="l700"></a><a href="#l700">700</a><td>/**<tr><td><a id="l701"></a><a href="#l701">701</a><td> * Cancels this Promise with the given error.<tr><td><a id="l702"></a><a href="#l702">702</a><td> *<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @param {!Error} err The cancellation error.<tr><td><a id="l704"></a><a href="#l704">704</a><td> * @private<tr><td><a id="l705"></a><a href="#l705">705</a><td> */<tr><td><a id="l706"></a><a href="#l706">706</a><td>goog.Promise.prototype.cancelInternal_ = function(err) {<tr><td><a id="l707"></a><a href="#l707">707</a><td> if (this.state_ == goog.Promise.State_.PENDING) {<tr><td><a id="l708"></a><a href="#l708">708</a><td> if (this.parent_) {<tr><td><a id="l709"></a><a href="#l709">709</a><td> // Cancel the Promise and remove it from the parent&#39;s child list.<tr><td><a id="l710"></a><a href="#l710">710</a><td> this.parent_.cancelChild_(this, err);<tr><td><a id="l711"></a><a href="#l711">711</a><td> this.parent_ = null;<tr><td><a id="l712"></a><a href="#l712">712</a><td> } else {<tr><td><a id="l713"></a><a href="#l713">713</a><td> this.resolve_(goog.Promise.State_.REJECTED, err);<tr><td><a id="l714"></a><a href="#l714">714</a><td> }<tr><td><a id="l715"></a><a href="#l715">715</a><td> }<tr><td><a id="l716"></a><a href="#l716">716</a><td>};<tr><td><a id="l717"></a><a href="#l717">717</a><td><tr><td><a id="l718"></a><a href="#l718">718</a><td><tr><td><a id="l719"></a><a href="#l719">719</a><td>/**<tr><td><a id="l720"></a><a href="#l720">720</a><td> * Cancels a child Promise from the list of callback entries. If the Promise has<tr><td><a id="l721"></a><a href="#l721">721</a><td> * not already been resolved, reject it with a cancel error. If there are no<tr><td><a id="l722"></a><a href="#l722">722</a><td> * other children in the list of callback entries, propagate the cancellation<tr><td><a id="l723"></a><a href="#l723">723</a><td> * by canceling this Promise as well.<tr><td><a id="l724"></a><a href="#l724">724</a><td> *<tr><td><a id="l725"></a><a href="#l725">725</a><td> * @param {!goog.Promise} childPromise The Promise to cancel.<tr><td><a id="l726"></a><a href="#l726">726</a><td> * @param {!Error} err The cancel error to use for rejecting the Promise.<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @private<tr><td><a id="l728"></a><a href="#l728">728</a><td> */<tr><td><a id="l729"></a><a href="#l729">729</a><td>goog.Promise.prototype.cancelChild_ = function(childPromise, err) {<tr><td><a id="l730"></a><a href="#l730">730</a><td> if (!this.callbackEntries_) {<tr><td><a id="l731"></a><a href="#l731">731</a><td> return;<tr><td><a id="l732"></a><a href="#l732">732</a><td> }<tr><td><a id="l733"></a><a href="#l733">733</a><td> var childCount = 0;<tr><td><a id="l734"></a><a href="#l734">734</a><td> var childEntry = null;<tr><td><a id="l735"></a><a href="#l735">735</a><td> var beforeChildEntry = null;<tr><td><a id="l736"></a><a href="#l736">736</a><td><tr><td><a id="l737"></a><a href="#l737">737</a><td> // Find the callback entry for the childPromise, and count whether there are<tr><td><a id="l738"></a><a href="#l738">738</a><td> // additional child Promises.<tr><td><a id="l739"></a><a href="#l739">739</a><td> for (var entry = this.callbackEntries_; entry; entry = entry.next) {<tr><td><a id="l740"></a><a href="#l740">740</a><td> if (!entry.always) {<tr><td><a id="l741"></a><a href="#l741">741</a><td> childCount++;<tr><td><a id="l742"></a><a href="#l742">742</a><td> if (entry.child == childPromise) {<tr><td><a id="l743"></a><a href="#l743">743</a><td> childEntry = entry;<tr><td><a id="l744"></a><a href="#l744">744</a><td> }<tr><td><a id="l745"></a><a href="#l745">745</a><td> if (childEntry &amp;&amp; childCount &gt; 1) {<tr><td><a id="l746"></a><a href="#l746">746</a><td> break;<tr><td><a id="l747"></a><a href="#l747">747</a><td> }<tr><td><a id="l748"></a><a href="#l748">748</a><td> }<tr><td><a id="l749"></a><a href="#l749">749</a><td> if (!childEntry) {<tr><td><a id="l750"></a><a href="#l750">750</a><td> beforeChildEntry = entry;<tr><td><a id="l751"></a><a href="#l751">751</a><td> }<tr><td><a id="l752"></a><a href="#l752">752</a><td> }<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td> // Can a child entry be missing?<tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td> // If the child Promise was the only child, cancel this Promise as well.<tr><td><a id="l757"></a><a href="#l757">757</a><td> // Otherwise, reject only the child Promise with the cancel error.<tr><td><a id="l758"></a><a href="#l758">758</a><td> if (childEntry) {<tr><td><a id="l759"></a><a href="#l759">759</a><td> if (this.state_ == goog.Promise.State_.PENDING &amp;&amp; childCount == 1) {<tr><td><a id="l760"></a><a href="#l760">760</a><td> this.cancelInternal_(err);<tr><td><a id="l761"></a><a href="#l761">761</a><td> } else {<tr><td><a id="l762"></a><a href="#l762">762</a><td> if (beforeChildEntry) {<tr><td><a id="l763"></a><a href="#l763">763</a><td> this.removeEntryAfter_(beforeChildEntry);<tr><td><a id="l764"></a><a href="#l764">764</a><td> } else {<tr><td><a id="l765"></a><a href="#l765">765</a><td> this.popEntry_();<tr><td><a id="l766"></a><a href="#l766">766</a><td> }<tr><td><a id="l767"></a><a href="#l767">767</a><td><tr><td><a id="l768"></a><a href="#l768">768</a><td> this.executeCallback_(<tr><td><a id="l769"></a><a href="#l769">769</a><td> childEntry, goog.Promise.State_.REJECTED, err);<tr><td><a id="l770"></a><a href="#l770">770</a><td> }<tr><td><a id="l771"></a><a href="#l771">771</a><td> }<tr><td><a id="l772"></a><a href="#l772">772</a><td>};<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * Adds a callback entry to the current Promise, and schedules callback<tr><td><a id="l777"></a><a href="#l777">777</a><td> * execution if the Promise has already been settled.<tr><td><a id="l778"></a><a href="#l778">778</a><td> *<tr><td><a id="l779"></a><a href="#l779">779</a><td> * @param {goog.Promise.CallbackEntry_} callbackEntry Record containing<tr><td><a id="l780"></a><a href="#l780">780</a><td> * {@code onFulfilled} and {@code onRejected} callbacks to execute after<tr><td><a id="l781"></a><a href="#l781">781</a><td> * the Promise is settled.<tr><td><a id="l782"></a><a href="#l782">782</a><td> * @private<tr><td><a id="l783"></a><a href="#l783">783</a><td> */<tr><td><a id="l784"></a><a href="#l784">784</a><td>goog.Promise.prototype.addCallbackEntry_ = function(callbackEntry) {<tr><td><a id="l785"></a><a href="#l785">785</a><td> if (!this.hasEntry_() &amp;&amp;<tr><td><a id="l786"></a><a href="#l786">786</a><td> (this.state_ == goog.Promise.State_.FULFILLED ||<tr><td><a id="l787"></a><a href="#l787">787</a><td> this.state_ == goog.Promise.State_.REJECTED)) {<tr><td><a id="l788"></a><a href="#l788">788</a><td> this.scheduleCallbacks_();<tr><td><a id="l789"></a><a href="#l789">789</a><td> }<tr><td><a id="l790"></a><a href="#l790">790</a><td> this.queueEntry_(callbackEntry);<tr><td><a id="l791"></a><a href="#l791">791</a><td>};<tr><td><a id="l792"></a><a href="#l792">792</a><td><tr><td><a id="l793"></a><a href="#l793">793</a><td><tr><td><a id="l794"></a><a href="#l794">794</a><td>/**<tr><td><a id="l795"></a><a href="#l795">795</a><td> * Creates a child Promise and adds it to the callback entry list. The result of<tr><td><a id="l796"></a><a href="#l796">796</a><td> * the child Promise is determined by the state of the parent Promise and the<tr><td><a id="l797"></a><a href="#l797">797</a><td> * result of the {@code onFulfilled} or {@code onRejected} callbacks as<tr><td><a id="l798"></a><a href="#l798">798</a><td> * specified in the Promise resolution procedure.<tr><td><a id="l799"></a><a href="#l799">799</a><td> *<tr><td><a id="l800"></a><a href="#l800">800</a><td> * @see http://promisesaplus.com/#the__method<tr><td><a id="l801"></a><a href="#l801">801</a><td> *<tr><td><a id="l802"></a><a href="#l802">802</a><td> * @param {?function(this:THIS, TYPE):<tr><td><a id="l803"></a><a href="#l803">803</a><td> * (RESULT|goog.Promise&lt;RESULT&gt;|Thenable)} onFulfilled A callback that<tr><td><a id="l804"></a><a href="#l804">804</a><td> * will be invoked if the Promise is fullfilled, or null.<tr><td><a id="l805"></a><a href="#l805">805</a><td> * @param {?function(this:THIS, *): *} onRejected A callback that will be<tr><td><a id="l806"></a><a href="#l806">806</a><td> * invoked if the Promise is rejected, or null.<tr><td><a id="l807"></a><a href="#l807">807</a><td> * @param {THIS=} opt_context An optional execution context for the callbacks.<tr><td><a id="l808"></a><a href="#l808">808</a><td> * in the default calling context.<tr><td><a id="l809"></a><a href="#l809">809</a><td> * @return {!goog.Promise} The child Promise.<tr><td><a id="l810"></a><a href="#l810">810</a><td> * @template RESULT,THIS<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @private<tr><td><a id="l812"></a><a href="#l812">812</a><td> */<tr><td><a id="l813"></a><a href="#l813">813</a><td>goog.Promise.prototype.addChildPromise_ = function(<tr><td><a id="l814"></a><a href="#l814">814</a><td> onFulfilled, onRejected, opt_context) {<tr><td><a id="l815"></a><a href="#l815">815</a><td><tr><td><a id="l816"></a><a href="#l816">816</a><td> /** @type {goog.Promise.CallbackEntry_} */<tr><td><a id="l817"></a><a href="#l817">817</a><td> var callbackEntry = goog.Promise.getCallbackEntry_(null, null, null);<tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td> callbackEntry.child = new goog.Promise(function(resolve, reject) {<tr><td><a id="l820"></a><a href="#l820">820</a><td> // Invoke onFulfilled, or resolve with the parent&#39;s value if absent.<tr><td><a id="l821"></a><a href="#l821">821</a><td> callbackEntry.onFulfilled = onFulfilled ? function(value) {<tr><td><a id="l822"></a><a href="#l822">822</a><td> try {<tr><td><a id="l823"></a><a href="#l823">823</a><td> var result = onFulfilled.call(opt_context, value);<tr><td><a id="l824"></a><a href="#l824">824</a><td> resolve(result);<tr><td><a id="l825"></a><a href="#l825">825</a><td> } catch (err) {<tr><td><a id="l826"></a><a href="#l826">826</a><td> reject(err);<tr><td><a id="l827"></a><a href="#l827">827</a><td> }<tr><td><a id="l828"></a><a href="#l828">828</a><td> } : resolve;<tr><td><a id="l829"></a><a href="#l829">829</a><td><tr><td><a id="l830"></a><a href="#l830">830</a><td> // Invoke onRejected, or reject with the parent&#39;s reason if absent.<tr><td><a id="l831"></a><a href="#l831">831</a><td> callbackEntry.onRejected = onRejected ? function(reason) {<tr><td><a id="l832"></a><a href="#l832">832</a><td> try {<tr><td><a id="l833"></a><a href="#l833">833</a><td> var result = onRejected.call(opt_context, reason);<tr><td><a id="l834"></a><a href="#l834">834</a><td> if (!goog.isDef(result) &amp;&amp;<tr><td><a id="l835"></a><a href="#l835">835</a><td> reason instanceof goog.Promise.CancellationError) {<tr><td><a id="l836"></a><a href="#l836">836</a><td> // Propagate cancellation to children if no other result is returned.<tr><td><a id="l837"></a><a href="#l837">837</a><td> reject(reason);<tr><td><a id="l838"></a><a href="#l838">838</a><td> } else {<tr><td><a id="l839"></a><a href="#l839">839</a><td> resolve(result);<tr><td><a id="l840"></a><a href="#l840">840</a><td> }<tr><td><a id="l841"></a><a href="#l841">841</a><td> } catch (err) {<tr><td><a id="l842"></a><a href="#l842">842</a><td> reject(err);<tr><td><a id="l843"></a><a href="#l843">843</a><td> }<tr><td><a id="l844"></a><a href="#l844">844</a><td> } : reject;<tr><td><a id="l845"></a><a href="#l845">845</a><td> });<tr><td><a id="l846"></a><a href="#l846">846</a><td><tr><td><a id="l847"></a><a href="#l847">847</a><td> callbackEntry.child.parent_ = this;<tr><td><a id="l848"></a><a href="#l848">848</a><td> this.addCallbackEntry_(callbackEntry);<tr><td><a id="l849"></a><a href="#l849">849</a><td> return callbackEntry.child;<tr><td><a id="l850"></a><a href="#l850">850</a><td>};<tr><td><a id="l851"></a><a href="#l851">851</a><td><tr><td><a id="l852"></a><a href="#l852">852</a><td><tr><td><a id="l853"></a><a href="#l853">853</a><td>/**<tr><td><a id="l854"></a><a href="#l854">854</a><td> * Unblocks the Promise and fulfills it with the given value.<tr><td><a id="l855"></a><a href="#l855">855</a><td> *<tr><td><a id="l856"></a><a href="#l856">856</a><td> * @param {TYPE} value<tr><td><a id="l857"></a><a href="#l857">857</a><td> * @private<tr><td><a id="l858"></a><a href="#l858">858</a><td> */<tr><td><a id="l859"></a><a href="#l859">859</a><td>goog.Promise.prototype.unblockAndFulfill_ = function(value) {<tr><td><a id="l860"></a><a href="#l860">860</a><td> goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);<tr><td><a id="l861"></a><a href="#l861">861</a><td> this.state_ = goog.Promise.State_.PENDING;<tr><td><a id="l862"></a><a href="#l862">862</a><td> this.resolve_(goog.Promise.State_.FULFILLED, value);<tr><td><a id="l863"></a><a href="#l863">863</a><td>};<tr><td><a id="l864"></a><a href="#l864">864</a><td><tr><td><a id="l865"></a><a href="#l865">865</a><td><tr><td><a id="l866"></a><a href="#l866">866</a><td>/**<tr><td><a id="l867"></a><a href="#l867">867</a><td> * Unblocks the Promise and rejects it with the given rejection reason.<tr><td><a id="l868"></a><a href="#l868">868</a><td> *<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @param {*} reason<tr><td><a id="l870"></a><a href="#l870">870</a><td> * @private<tr><td><a id="l871"></a><a href="#l871">871</a><td> */<tr><td><a id="l872"></a><a href="#l872">872</a><td>goog.Promise.prototype.unblockAndReject_ = function(reason) {<tr><td><a id="l873"></a><a href="#l873">873</a><td> goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);<tr><td><a id="l874"></a><a href="#l874">874</a><td> this.state_ = goog.Promise.State_.PENDING;<tr><td><a id="l875"></a><a href="#l875">875</a><td> this.resolve_(goog.Promise.State_.REJECTED, reason);<tr><td><a id="l876"></a><a href="#l876">876</a><td>};<tr><td><a id="l877"></a><a href="#l877">877</a><td><tr><td><a id="l878"></a><a href="#l878">878</a><td><tr><td><a id="l879"></a><a href="#l879">879</a><td>/**<tr><td><a id="l880"></a><a href="#l880">880</a><td> * Attempts to resolve a Promise with a given resolution state and value. This<tr><td><a id="l881"></a><a href="#l881">881</a><td> * is a no-op if the given Promise has already been resolved.<tr><td><a id="l882"></a><a href="#l882">882</a><td> *<tr><td><a id="l883"></a><a href="#l883">883</a><td> * If the given result is a Thenable (such as another Promise), the Promise will<tr><td><a id="l884"></a><a href="#l884">884</a><td> * be settled with the same state and result as the Thenable once it is itself<tr><td><a id="l885"></a><a href="#l885">885</a><td> * settled.<tr><td><a id="l886"></a><a href="#l886">886</a><td> *<tr><td><a id="l887"></a><a href="#l887">887</a><td> * If the given result is not a Thenable, the Promise will be settled (fulfilled<tr><td><a id="l888"></a><a href="#l888">888</a><td> * or rejected) with that result based on the given state.<tr><td><a id="l889"></a><a href="#l889">889</a><td> *<tr><td><a id="l890"></a><a href="#l890">890</a><td> * @see http://promisesaplus.com/#the_promise_resolution_procedure<tr><td><a id="l891"></a><a href="#l891">891</a><td> *<tr><td><a id="l892"></a><a href="#l892">892</a><td> * @param {goog.Promise.State_} state<tr><td><a id="l893"></a><a href="#l893">893</a><td> * @param {*} x The result to apply to the Promise.<tr><td><a id="l894"></a><a href="#l894">894</a><td> * @private<tr><td><a id="l895"></a><a href="#l895">895</a><td> */<tr><td><a id="l896"></a><a href="#l896">896</a><td>goog.Promise.prototype.resolve_ = function(state, x) {<tr><td><a id="l897"></a><a href="#l897">897</a><td> if (this.state_ != goog.Promise.State_.PENDING) {<tr><td><a id="l898"></a><a href="#l898">898</a><td> return;<tr><td><a id="l899"></a><a href="#l899">899</a><td> }<tr><td><a id="l900"></a><a href="#l900">900</a><td><tr><td><a id="l901"></a><a href="#l901">901</a><td> if (this == x) {<tr><td><a id="l902"></a><a href="#l902">902</a><td> state = goog.Promise.State_.REJECTED;<tr><td><a id="l903"></a><a href="#l903">903</a><td> x = new TypeError(&#39;Promise cannot resolve to itself&#39;);<tr><td><a id="l904"></a><a href="#l904">904</a><td><tr><td><a id="l905"></a><a href="#l905">905</a><td> } else if (goog.Thenable.isImplementedBy(x)) {<tr><td><a id="l906"></a><a href="#l906">906</a><td> x = /** @type {!goog.Thenable} */ (x);<tr><td><a id="l907"></a><a href="#l907">907</a><td> this.state_ = goog.Promise.State_.BLOCKED;<tr><td><a id="l908"></a><a href="#l908">908</a><td> goog.Promise.maybeThenVoid_(<tr><td><a id="l909"></a><a href="#l909">909</a><td> x, this.unblockAndFulfill_, this.unblockAndReject_, this);<tr><td><a id="l910"></a><a href="#l910">910</a><td> return;<tr><td><a id="l911"></a><a href="#l911">911</a><td> } else if (goog.isObject(x)) {<tr><td><a id="l912"></a><a href="#l912">912</a><td> try {<tr><td><a id="l913"></a><a href="#l913">913</a><td> var then = x[&#39;then&#39;];<tr><td><a id="l914"></a><a href="#l914">914</a><td> if (goog.isFunction(then)) {<tr><td><a id="l915"></a><a href="#l915">915</a><td> this.tryThen_(x, then);<tr><td><a id="l916"></a><a href="#l916">916</a><td> return;<tr><td><a id="l917"></a><a href="#l917">917</a><td> }<tr><td><a id="l918"></a><a href="#l918">918</a><td> } catch (e) {<tr><td><a id="l919"></a><a href="#l919">919</a><td> state = goog.Promise.State_.REJECTED;<tr><td><a id="l920"></a><a href="#l920">920</a><td> x = e;<tr><td><a id="l921"></a><a href="#l921">921</a><td> }<tr><td><a id="l922"></a><a href="#l922">922</a><td> }<tr><td><a id="l923"></a><a href="#l923">923</a><td><tr><td><a id="l924"></a><a href="#l924">924</a><td> this.result_ = x;<tr><td><a id="l925"></a><a href="#l925">925</a><td> this.state_ = state;<tr><td><a id="l926"></a><a href="#l926">926</a><td> // Since we can no longer be cancelled, remove link to parent, so that the<tr><td><a id="l927"></a><a href="#l927">927</a><td> // child promise does not keep the parent promise alive.<tr><td><a id="l928"></a><a href="#l928">928</a><td> this.parent_ = null;<tr><td><a id="l929"></a><a href="#l929">929</a><td> this.scheduleCallbacks_();<tr><td><a id="l930"></a><a href="#l930">930</a><td><tr><td><a id="l931"></a><a href="#l931">931</a><td> if (state == goog.Promise.State_.REJECTED &amp;&amp;<tr><td><a id="l932"></a><a href="#l932">932</a><td> !(x instanceof goog.Promise.CancellationError)) {<tr><td><a id="l933"></a><a href="#l933">933</a><td> goog.Promise.addUnhandledRejection_(this, x);<tr><td><a id="l934"></a><a href="#l934">934</a><td> }<tr><td><a id="l935"></a><a href="#l935">935</a><td>};<tr><td><a id="l936"></a><a href="#l936">936</a><td><tr><td><a id="l937"></a><a href="#l937">937</a><td><tr><td><a id="l938"></a><a href="#l938">938</a><td>/**<tr><td><a id="l939"></a><a href="#l939">939</a><td> * Attempts to call the {@code then} method on an object in the hopes that it is<tr><td><a id="l940"></a><a href="#l940">940</a><td> * a Promise-compatible instance. This allows interoperation between different<tr><td><a id="l941"></a><a href="#l941">941</a><td> * Promise implementations, however a non-compliant object may cause a Promise<tr><td><a id="l942"></a><a href="#l942">942</a><td> * to hang indefinitely. If the {@code then} method throws an exception, the<tr><td><a id="l943"></a><a href="#l943">943</a><td> * dependent Promise will be rejected with the thrown value.<tr><td><a id="l944"></a><a href="#l944">944</a><td> *<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @see http://promisesaplus.com/#point-70<tr><td><a id="l946"></a><a href="#l946">946</a><td> *<tr><td><a id="l947"></a><a href="#l947">947</a><td> * @param {Thenable} thenable An object with a {@code then} method that may be<tr><td><a id="l948"></a><a href="#l948">948</a><td> * compatible with the Promise/A+ specification.<tr><td><a id="l949"></a><a href="#l949">949</a><td> * @param {!Function} then The {@code then} method of the Thenable object.<tr><td><a id="l950"></a><a href="#l950">950</a><td> * @private<tr><td><a id="l951"></a><a href="#l951">951</a><td> */<tr><td><a id="l952"></a><a href="#l952">952</a><td>goog.Promise.prototype.tryThen_ = function(thenable, then) {<tr><td><a id="l953"></a><a href="#l953">953</a><td> this.state_ = goog.Promise.State_.BLOCKED;<tr><td><a id="l954"></a><a href="#l954">954</a><td> var promise = this;<tr><td><a id="l955"></a><a href="#l955">955</a><td> var called = false;<tr><td><a id="l956"></a><a href="#l956">956</a><td><tr><td><a id="l957"></a><a href="#l957">957</a><td> var resolve = function(value) {<tr><td><a id="l958"></a><a href="#l958">958</a><td> if (!called) {<tr><td><a id="l959"></a><a href="#l959">959</a><td> called = true;<tr><td><a id="l960"></a><a href="#l960">960</a><td> promise.unblockAndFulfill_(value);<tr><td><a id="l961"></a><a href="#l961">961</a><td> }<tr><td><a id="l962"></a><a href="#l962">962</a><td> };<tr><td><a id="l963"></a><a href="#l963">963</a><td><tr><td><a id="l964"></a><a href="#l964">964</a><td> var reject = function(reason) {<tr><td><a id="l965"></a><a href="#l965">965</a><td> if (!called) {<tr><td><a id="l966"></a><a href="#l966">966</a><td> called = true;<tr><td><a id="l967"></a><a href="#l967">967</a><td> promise.unblockAndReject_(reason);<tr><td><a id="l968"></a><a href="#l968">968</a><td> }<tr><td><a id="l969"></a><a href="#l969">969</a><td> };<tr><td><a id="l970"></a><a href="#l970">970</a><td><tr><td><a id="l971"></a><a href="#l971">971</a><td> try {<tr><td><a id="l972"></a><a href="#l972">972</a><td> then.call(thenable, resolve, reject);<tr><td><a id="l973"></a><a href="#l973">973</a><td> } catch (e) {<tr><td><a id="l974"></a><a href="#l974">974</a><td> reject(e);<tr><td><a id="l975"></a><a href="#l975">975</a><td> }<tr><td><a id="l976"></a><a href="#l976">976</a><td>};<tr><td><a id="l977"></a><a href="#l977">977</a><td><tr><td><a id="l978"></a><a href="#l978">978</a><td><tr><td><a id="l979"></a><a href="#l979">979</a><td>/**<tr><td><a id="l980"></a><a href="#l980">980</a><td> * Executes the pending callbacks of a settled Promise after a timeout.<tr><td><a id="l981"></a><a href="#l981">981</a><td> *<tr><td><a id="l982"></a><a href="#l982">982</a><td> * Section 2.2.4 of the Promises/A+ specification requires that Promise<tr><td><a id="l983"></a><a href="#l983">983</a><td> * callbacks must only be invoked from a call stack that only contains Promise<tr><td><a id="l984"></a><a href="#l984">984</a><td> * implementation code, which we accomplish by invoking callback execution after<tr><td><a id="l985"></a><a href="#l985">985</a><td> * a timeout. If {@code startExecution_} is called multiple times for the same<tr><td><a id="l986"></a><a href="#l986">986</a><td> * Promise, the callback chain will be evaluated only once. Additional callbacks<tr><td><a id="l987"></a><a href="#l987">987</a><td> * may be added during the evaluation phase, and will be executed in the same<tr><td><a id="l988"></a><a href="#l988">988</a><td> * event loop.<tr><td><a id="l989"></a><a href="#l989">989</a><td> *<tr><td><a id="l990"></a><a href="#l990">990</a><td> * All Promises added to the waiting list during the same browser event loop<tr><td><a id="l991"></a><a href="#l991">991</a><td> * will be executed in one batch to avoid using a separate timeout per Promise.<tr><td><a id="l992"></a><a href="#l992">992</a><td> *<tr><td><a id="l993"></a><a href="#l993">993</a><td> * @private<tr><td><a id="l994"></a><a href="#l994">994</a><td> */<tr><td><a id="l995"></a><a href="#l995">995</a><td>goog.Promise.prototype.scheduleCallbacks_ = function() {<tr><td><a id="l996"></a><a href="#l996">996</a><td> if (!this.executing_) {<tr><td><a id="l997"></a><a href="#l997">997</a><td> this.executing_ = true;<tr><td><a id="l998"></a><a href="#l998">998</a><td> goog.async.run(this.executeCallbacks_, this);<tr><td><a id="l999"></a><a href="#l999">999</a><td> }<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>};<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td><tr><td><a id="l1002"></a><a href="#l1002">1002</a><td><tr><td><a id="l1003"></a><a href="#l1003">1003</a><td>/**<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> * @return {boolean} Whether there are any pending callbacks queued.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> * @private<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> */<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>goog.Promise.prototype.hasEntry_ = function() {<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> return !!this.callbackEntries_;<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>};<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td><tr><td><a id="l1011"></a><a href="#l1011">1011</a><td><tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>/**<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td> * @param {goog.Promise.CallbackEntry_} entry<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td> * @private<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td> */<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>goog.Promise.prototype.queueEntry_ = function(entry) {<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td> goog.asserts.assert(entry.onFulfilled != null);<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td><tr><td><a id="l1019"></a><a href="#l1019">1019</a><td> if (this.callbackEntriesTail_) {<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td> this.callbackEntriesTail_.next = entry;<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td> this.callbackEntriesTail_ = entry;<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> } else {<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> // It the work queue was empty set the head too.<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td> this.callbackEntries_ = entry;<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td> this.callbackEntriesTail_ = entry;<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td> }<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>};<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td><tr><td><a id="l1029"></a><a href="#l1029">1029</a><td><tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>/**<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td> * @return {goog.Promise.CallbackEntry_} entry<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td> * @private<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td> */<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>goog.Promise.prototype.popEntry_ = function() {<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td> var entry = null;<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td> if (this.callbackEntries_) {<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td> entry = this.callbackEntries_;<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td> this.callbackEntries_ = entry.next;<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td> entry.next = null;<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td> }<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td> // It the work queue is empty clear the tail too.<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td> if (!this.callbackEntries_) {<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td> this.callbackEntriesTail_ = null;<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td> }<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td><tr><td><a id="l1046"></a><a href="#l1046">1046</a><td> if (entry != null) {<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td> goog.asserts.assert(entry.onFulfilled != null);<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td> }<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td> return entry;<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>};<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td><tr><td><a id="l1052"></a><a href="#l1052">1052</a><td><tr><td><a id="l1053"></a><a href="#l1053">1053</a><td>/**<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> * @param {goog.Promise.CallbackEntry_} previous<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> * @private<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> */<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>goog.Promise.prototype.removeEntryAfter_ = function(previous) {<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> goog.asserts.assert(this.callbackEntries_);<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> goog.asserts.assert(previous != null);<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> // If the last entry is being removed, update the tail<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td> if (previous.next == this.callbackEntriesTail_) {<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> this.callbackEntriesTail_ = previous;<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> }<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td><tr><td><a id="l1065"></a><a href="#l1065">1065</a><td> previous.next = previous.next.next;<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>};<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td><tr><td><a id="l1068"></a><a href="#l1068">1068</a><td><tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>/**<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td> * Executes all pending callbacks for this Promise.<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td> *<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td> * @private<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> */<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>goog.Promise.prototype.executeCallbacks_ = function() {<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td> var entry = null;<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td> while (entry = this.popEntry_()) {<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td> if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td> this.currentStep_++;<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td> }<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td> this.executeCallback_(entry, this.state_, this.result_);<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td> }<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td> this.executing_ = false;<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>};<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td><tr><td><a id="l1085"></a><a href="#l1085">1085</a><td><tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>/**<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td> * Executes a pending callback for this Promise. Invokes an {@code onFulfilled}<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td> * or {@code onRejected} callback based on the settled state of the Promise.<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td> *<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td> * @param {!goog.Promise.CallbackEntry_} callbackEntry An entry containing the<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td> * onFulfilled and/or onRejected callbacks for this step.<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td> * @param {goog.Promise.State_} state The resolution status of the Promise,<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td> * either FULFILLED or REJECTED.<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td> * @param {*} result The settled result of the Promise.<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> * @private<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> */<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>goog.Promise.prototype.executeCallback_ = function(<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td> callbackEntry, state, result) {<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td> // Cancel an unhandled rejection if the then/thenVoid call had an onRejected.<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td> if (state == goog.Promise.State_.REJECTED &amp;&amp;<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td> callbackEntry.onRejected &amp;&amp; !callbackEntry.always) {<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td> this.removeUnhandledRejection_();<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td> }<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td> if (callbackEntry.child) {<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td> // When the parent is settled, the child no longer needs to hold on to it,<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td> // as the parent can no longer be canceled.<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td> callbackEntry.child.parent_ = null;<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td> goog.Promise.invokeCallback_(callbackEntry, state, result);<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> } else {<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td> // Callbacks created with thenAlways or thenVoid do not have the rejection<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td> // handling code normally set up in the child Promise.<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td> try {<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td> callbackEntry.always ?<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td> callbackEntry.onFulfilled.call(callbackEntry.context) :<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td> goog.Promise.invokeCallback_(callbackEntry, state, result);<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> } catch (err) {<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> goog.Promise.handleRejection_.call(null, err);<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> }<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> }<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> goog.Promise.returnEntry_(callbackEntry);<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>};<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td><tr><td><a id="l1124"></a><a href="#l1124">1124</a><td><tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>/**<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td> * Executes the onFulfilled or onRejected callback for a callbackEntry.<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td> *<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td> * @param {!goog.Promise.CallbackEntry_} callbackEntry<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td> * @param {goog.Promise.State_} state<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td> * @param {*} result<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> * @private<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> */<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td>goog.Promise.invokeCallback_ = function(callbackEntry, state, result) {<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> if (state == goog.Promise.State_.FULFILLED) {<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> callbackEntry.onFulfilled.call(callbackEntry.context, result);<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> } else if (callbackEntry.onRejected) {<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td> callbackEntry.onRejected.call(callbackEntry.context, result);<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td> }<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>};<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td><tr><td><a id="l1141"></a><a href="#l1141">1141</a><td><tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>/**<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td> * Records a stack trace entry for functions that call {@code then} or the<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td> * Promise constructor. May be disabled by unsetting {@code LONG_STACK_TRACES}.<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td> *<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td> * @param {!Error} err An Error object created by the calling function for<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td> * providing a stack trace.<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td> * @private<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td> */<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>goog.Promise.prototype.addStackTrace_ = function(err) {<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td> if (goog.Promise.LONG_STACK_TRACES &amp;&amp; goog.isString(err.stack)) {<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td> // Extract the third line of the stack trace, which is the entry for the<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td> // user function that called into Promise code.<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td> var trace = err.stack.split(&#39;\n&#39;, 4)[3];<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> var message = err.message;<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td><tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> // Pad the message to align the traces.<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> message += Array(11 - message.length).join(&#39; &#39;);<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> this.stack_.push(message + trace);<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> }<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>};<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td><tr><td><a id="l1163"></a><a href="#l1163">1163</a><td><tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>/**<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td> * Adds extra stack trace information to an exception for the list of<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td> * asynchronous {@code then} calls that have been run for this Promise. Stack<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td> * trace information is recorded in {@see #addStackTrace_}, and appended to<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td> * rethrown errors when {@code LONG_STACK_TRACES} is enabled.<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td> *<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td> * @param {*} err An unhandled exception captured during callback execution.<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td> * @private<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td> */<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td>goog.Promise.prototype.appendLongStack_ = function(err) {<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td> if (goog.Promise.LONG_STACK_TRACES &amp;&amp;<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td> err &amp;&amp; goog.isString(err.stack) &amp;&amp; this.stack_.length) {<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td> var longTrace = [&#39;Promise trace:&#39;];<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td><tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> for (var promise = this; promise; promise = promise.parent_) {<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td> for (var i = this.currentStep_; i &gt;= 0; i--) {<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td> longTrace.push(promise.stack_[i]);<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> }<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td> longTrace.push(&#39;Value: &#39; +<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td> &#39;[&#39; + (promise.state_ == goog.Promise.State_.REJECTED ?<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td> &#39;REJECTED&#39; : &#39;FULFILLED&#39;) + &#39;] &#39; +<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td> &#39;&lt;&#39; + String(promise.result_) + &#39;&gt;&#39;);<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td> }<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td> err.stack += &#39;\n\n&#39; + longTrace.join(&#39;\n&#39;);<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td> }<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>};<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td><tr><td><a id="l1191"></a><a href="#l1191">1191</a><td><tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>/**<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td> * Marks this rejected Promise as having being handled. Also marks any parent<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td> * Promises in the rejected state as handled. The rejection handler will no<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td> * longer be invoked for this Promise (if it has not been called already).<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td> *<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td> * @private<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td> */<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>goog.Promise.prototype.removeUnhandledRejection_ = function() {<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td> if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> for (var p = this; p &amp;&amp; p.unhandledRejectionId_; p = p.parent_) {<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> goog.global.clearTimeout(p.unhandledRejectionId_);<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> p.unhandledRejectionId_ = 0;<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> }<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> for (var p = this; p &amp;&amp; p.hadUnhandledRejection_; p = p.parent_) {<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> p.hadUnhandledRejection_ = false;<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> }<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td> }<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>};<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td><tr><td><a id="l1212"></a><a href="#l1212">1212</a><td><tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>/**<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td> * Marks this rejected Promise as unhandled. If no {@code onRejected} callback<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td> * is called for this Promise before the {@code UNHANDLED_REJECTION_DELAY}<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> * expires, the reason will be passed to the unhandled rejection handler. The<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td> * handler typically rethrows the rejection reason so that it becomes visible in<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td> * the developer console.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td> *<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td> * @param {!goog.Promise} promise The rejected Promise.<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td> * @param {*} reason The Promise rejection reason.<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td> * @private<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td> */<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>goog.Promise.addUnhandledRejection_ = function(promise, reason) {<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td> if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td> promise.unhandledRejectionId_ = goog.global.setTimeout(function() {<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td> promise.appendLongStack_(reason);<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> goog.Promise.handleRejection_.call(null, reason);<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td> }, goog.Promise.UNHANDLED_REJECTION_DELAY);<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td><tr><td><a id="l1231"></a><a href="#l1231">1231</a><td> } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td> promise.hadUnhandledRejection_ = true;<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td> goog.async.run(function() {<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> if (promise.hadUnhandledRejection_) {<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> promise.appendLongStack_(reason);<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> goog.Promise.handleRejection_.call(null, reason);<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> }<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> });<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td> }<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>};<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td><tr><td><a id="l1242"></a><a href="#l1242">1242</a><td><tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>/**<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> * A method that is invoked with the rejection reasons for Promises that are<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td> * rejected but have no {@code onRejected} callbacks registered yet.<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td> * @type {function(*)}<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td> * @private<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td> */<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>goog.Promise.handleRejection_ = goog.async.throwException;<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td><tr><td><a id="l1251"></a><a href="#l1251">1251</a><td><tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>/**<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td> * Sets a handler that will be called with reasons from unhandled rejected<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td> * Promises. If the rejected Promise (or one of its descendants) has an<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td> * {@code onRejected} callback registered, the rejection will be considered<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * handled, and the rejection handler will not be called.<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> *<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * By default, unhandled rejections are rethrown so that the error may be<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> * captured by the developer console or a {@code window.onerror} handler.<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> *<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td> * @param {function(*)} handler A function that will be called with reasons from<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td> * rejected Promises. Defaults to {@code goog.async.throwException}.<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td> */<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>goog.Promise.setUnhandledRejectionHandler = function(handler) {<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td> goog.Promise.handleRejection_ = handler;<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>};<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td><tr><td><a id="l1268"></a><a href="#l1268">1268</a><td><tr><td><a id="l1269"></a><a href="#l1269">1269</a><td><tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>/**<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td> * Error used as a rejection reason for canceled Promises.<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> *<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * @param {string=} opt_message<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * @constructor<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> * @extends {goog.debug.Error}<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> * @final<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td> */<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>goog.Promise.CancellationError = function(opt_message) {<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td> goog.Promise.CancellationError.base(this, &#39;constructor&#39;, opt_message);<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>};<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>goog.inherits(goog.Promise.CancellationError, goog.debug.Error);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td><tr><td><a id="l1283"></a><a href="#l1283">1283</a><td><tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>/** @override */<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>goog.Promise.CancellationError.prototype.name = &#39;cancel&#39;;<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td><tr><td><a id="l1287"></a><a href="#l1287">1287</a><td><tr><td><a id="l1288"></a><a href="#l1288">1288</a><td><tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>/**<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td> * Internal implementation of the resolver interface.<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td> *<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td> * @param {!goog.Promise&lt;TYPE&gt;} promise<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * @param {function((TYPE|goog.Promise&lt;TYPE&gt;|Thenable)=)} resolve<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * @param {function(*=): void} reject<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> * @implements {goog.promise.Resolver&lt;TYPE&gt;}<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @final @struct<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> * @constructor<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> * @private<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td> * @template TYPE<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td> */<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>goog.Promise.Resolver_ = function(promise, resolve, reject) {<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td> /** @const */<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td> this.promise = promise;<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td><tr><td><a id="l1305"></a><a href="#l1305">1305</a><td> /** @const */<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td> this.resolve = resolve;<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td><tr><td><a id="l1308"></a><a href="#l1308">1308</a><td> /** @const */<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td> this.reject = reject;<tr><td><a id="l1310"></a><a href="#l1310">1310</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/promise/resolver.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>resolver.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/promise/resolver.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.promise.Resolver&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Resolver interface for promises. The resolver is a convenience interface that<tr><td><a id="l21"></a><a href="#l21">21</a><td> * bundles the promise and its associated resolve and reject functions together,<tr><td><a id="l22"></a><a href="#l22">22</a><td> * for cases where the resolver needs to be persisted internally.<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @interface<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @template TYPE<tr><td><a id="l26"></a><a href="#l26">26</a><td> */<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.promise.Resolver = function() {};<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>/**<tr><td><a id="l31"></a><a href="#l31">31</a><td> * The promise that created this resolver.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @type {!goog.Promise&lt;TYPE&gt;}<tr><td><a id="l33"></a><a href="#l33">33</a><td> */<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.promise.Resolver.prototype.promise;<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>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Resolves this resolver with the specified value.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @type {function((TYPE|goog.Promise&lt;TYPE&gt;|Thenable)=)}<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.promise.Resolver.prototype.resolve;<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> * Rejects this resolver with the specified reason.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @type {function(*=): void}<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.promise.Resolver.prototype.reject;</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/promise/thenable.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>thenable.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/promise/thenable.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.Thenable&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Provides a more strict interface for Thenables in terms of<tr><td><a id="l21"></a><a href="#l21">21</a><td> * http://promisesaplus.com for interop with {@see goog.Promise}.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @interface<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @extends {IThenable&lt;TYPE&gt;}<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @template TYPE<tr><td><a id="l26"></a><a href="#l26">26</a><td> */<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.Thenable = function() {};<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>/**<tr><td><a id="l31"></a><a href="#l31">31</a><td> * Adds callbacks that will operate on the result of the Thenable, returning a<tr><td><a id="l32"></a><a href="#l32">32</a><td> * new child Promise.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * If the Thenable is fulfilled, the {@code onFulfilled} callback will be<tr><td><a id="l35"></a><a href="#l35">35</a><td> * invoked with the fulfillment value as argument, and the child Promise will<tr><td><a id="l36"></a><a href="#l36">36</a><td> * be fulfilled with the return value of the callback. If the callback throws<tr><td><a id="l37"></a><a href="#l37">37</a><td> * an exception, the child Promise will be rejected with the thrown value<tr><td><a id="l38"></a><a href="#l38">38</a><td> * instead.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * If the Thenable is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l41"></a><a href="#l41">41</a><td> * with the rejection reason as argument, and the child Promise will be rejected<tr><td><a id="l42"></a><a href="#l42">42</a><td> * with the return value of the callback or thrown value.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {?(function(this:THIS, TYPE): VALUE)=} opt_onFulfilled A<tr><td><a id="l45"></a><a href="#l45">45</a><td> * function that will be invoked with the fulfillment value if the Promise<tr><td><a id="l46"></a><a href="#l46">46</a><td> * is fullfilled.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will<tr><td><a id="l48"></a><a href="#l48">48</a><td> * be invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l50"></a><a href="#l50">50</a><td> * execution context for the callbacks. By default, functions are executed<tr><td><a id="l51"></a><a href="#l51">51</a><td> * with the default this.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @return {RESULT} A new Promise that will receive the result<tr><td><a id="l54"></a><a href="#l54">54</a><td> * of the fulfillment or rejection callback.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @template VALUE<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @template THIS<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * When a Promise (or thenable) is returned from the fulfilled callback,<tr><td><a id="l59"></a><a href="#l59">59</a><td> * the result is the payload of that promise, not the promise itself.<tr><td><a id="l60"></a><a href="#l60">60</a><td> *<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @template RESULT := type(&#39;goog.Promise&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td> * cond(isUnknown(VALUE), unknown(),<tr><td><a id="l63"></a><a href="#l63">63</a><td> * mapunion(VALUE, (V) =&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> * cond(isTemplatized(V) &amp;&amp; sub(rawTypeOf(V), &#39;IThenable&#39;),<tr><td><a id="l65"></a><a href="#l65">65</a><td> * templateTypeOf(V, 0),<tr><td><a id="l66"></a><a href="#l66">66</a><td> * cond(sub(V, &#39;Thenable&#39;),<tr><td><a id="l67"></a><a href="#l67">67</a><td> * unknown(),<tr><td><a id="l68"></a><a href="#l68">68</a><td> * V)))))<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>goog.Thenable.prototype.then = function(opt_onFulfilled, opt_onRejected,<tr><td><a id="l73"></a><a href="#l73">73</a><td> opt_context) {};<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> * An expando property to indicate that an object implements<tr><td><a id="l78"></a><a href="#l78">78</a><td> * {@code goog.Thenable}.<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> * {@see addImplementation}.<tr><td><a id="l81"></a><a href="#l81">81</a><td> *<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @const<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.Thenable.IMPLEMENTED_BY_PROP = &#39;$goog_Thenable&#39;;<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> * Marks a given class (constructor) as an implementation of Thenable, so<tr><td><a id="l89"></a><a href="#l89">89</a><td> * that we can query that fact at runtime. The class must have already<tr><td><a id="l90"></a><a href="#l90">90</a><td> * implemented the interface.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * Exports a &#39;then&#39; method on the constructor prototype, so that the objects<tr><td><a id="l92"></a><a href="#l92">92</a><td> * also implement the extern {@see goog.Thenable} interface for interop with<tr><td><a id="l93"></a><a href="#l93">93</a><td> * other Promise implementations.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {function(new:goog.Thenable,...?)} ctor The class constructor. The<tr><td><a id="l95"></a><a href="#l95">95</a><td> * corresponding class must have already implemented the interface.<tr><td><a id="l96"></a><a href="#l96">96</a><td> */<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.Thenable.addImplementation = function(ctor) {<tr><td><a id="l98"></a><a href="#l98">98</a><td> goog.exportProperty(ctor.prototype, &#39;then&#39;, ctor.prototype.then);<tr><td><a id="l99"></a><a href="#l99">99</a><td> if (COMPILED) {<tr><td><a id="l100"></a><a href="#l100">100</a><td> ctor.prototype[goog.Thenable.IMPLEMENTED_BY_PROP] = true;<tr><td><a id="l101"></a><a href="#l101">101</a><td> } else {<tr><td><a id="l102"></a><a href="#l102">102</a><td> // Avoids dictionary access in uncompiled mode.<tr><td><a id="l103"></a><a href="#l103">103</a><td> ctor.prototype.$goog_Thenable = true;<tr><td><a id="l104"></a><a href="#l104">104</a><td> }<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>/**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @param {*} object<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @return {boolean} Whether a given instance implements {@code goog.Thenable}.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * The class/superclass of the instance must call {@code addImplementation}.<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.Thenable.isImplementedBy = function(object) {<tr><td><a id="l114"></a><a href="#l114">114</a><td> if (!object) {<tr><td><a id="l115"></a><a href="#l115">115</a><td> return false;<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td> try {<tr><td><a id="l118"></a><a href="#l118">118</a><td> if (COMPILED) {<tr><td><a id="l119"></a><a href="#l119">119</a><td> return !!object[goog.Thenable.IMPLEMENTED_BY_PROP];<tr><td><a id="l120"></a><a href="#l120">120</a><td> }<tr><td><a id="l121"></a><a href="#l121">121</a><td> return !!object.$goog_Thenable;<tr><td><a id="l122"></a><a href="#l122">122</a><td> } catch (e) {<tr><td><a id="l123"></a><a href="#l123">123</a><td> // Property access seems to be forbidden.<tr><td><a id="l124"></a><a href="#l124">124</a><td> return false;<tr><td><a id="l125"></a><a href="#l125">125</a><td> }<tr><td><a id="l126"></a><a href="#l126">126</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/reflect/reflect.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>reflect.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/reflect/reflect.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 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 Useful compiler idioms.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author johnlenz@google.com (John Lenz)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.reflect&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/**<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Syntax for object literal casts.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @see http://go/jscompiler-renaming<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @see http://code.google.com/p/closure-compiler/wiki/<tr><td><a id="l28"></a><a href="#l28">28</a><td> * ExperimentalTypeBasedPropertyRenaming<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Use this if you have an object literal whose keys need to have the same names<tr><td><a id="l31"></a><a href="#l31">31</a><td> * as the properties of some class even after they are renamed by the compiler.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {!Function} type Type to cast to.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {Object} object Object literal to cast.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @return {Object} The object literal.<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.reflect.object = function(type, object) {<tr><td><a id="l38"></a><a href="#l38">38</a><td> return object;<tr><td><a id="l39"></a><a href="#l39">39</a><td>};<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * To assert to the compiler that an operation is needed when it would<tr><td><a id="l44"></a><a href="#l44">44</a><td> * otherwise be stripped. For example:<tr><td><a id="l45"></a><a href="#l45">45</a><td> * &lt;code&gt;<tr><td><a id="l46"></a><a href="#l46">46</a><td> * // Force a layout<tr><td><a id="l47"></a><a href="#l47">47</a><td> * goog.reflect.sinkValue(dialog.offsetHeight);<tr><td><a id="l48"></a><a href="#l48">48</a><td> * &lt;/code&gt;<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @type {!Function}<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.reflect.sinkValue = function(x) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> goog.reflect.sinkValue[&#39; &#39;](x);<tr><td><a id="l53"></a><a href="#l53">53</a><td> return x;<tr><td><a id="l54"></a><a href="#l54">54</a><td>};<tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * The compiler should optimize this function away iff no one ever uses<tr><td><a id="l59"></a><a href="#l59">59</a><td> * goog.reflect.sinkValue.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.reflect.sinkValue[&#39; &#39;] = goog.nullFunction;<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> * Check if a property can be accessed without throwing an exception.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @param {Object} obj The owner of the property.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {string} prop The property name.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {boolean} Whether the property is accessible. Will also return true<tr><td><a id="l69"></a><a href="#l69">69</a><td> * if obj is null.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.reflect.canAccessProperty = function(obj, prop) {<tr><td><a id="l72"></a><a href="#l72">72</a><td> /** @preserveTry */<tr><td><a id="l73"></a><a href="#l73">73</a><td> try {<tr><td><a id="l74"></a><a href="#l74">74</a><td> goog.reflect.sinkValue(obj[prop]);<tr><td><a id="l75"></a><a href="#l75">75</a><td> return true;<tr><td><a id="l76"></a><a href="#l76">76</a><td> } catch (e) {}<tr><td><a id="l77"></a><a href="#l77">77</a><td> return false;<tr><td><a id="l78"></a><a href="#l78">78</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>