selenium-webdriver 2.43.5 → 2.44.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 (219) hide show
  1. package/CHANGES.md +20 -0
  2. package/README.md +8 -13
  3. package/builder.js +4 -3
  4. package/docs/class_webdriver_Alert.html +6 -6
  5. package/docs/class_webdriver_AlertPromise.html +6 -6
  6. package/docs/class_webdriver_UnhandledAlertError.html +4 -4
  7. package/docs/class_webdriver_WebDriver.html +39 -37
  8. package/docs/class_webdriver_WebDriver_Logs.html +3 -3
  9. package/docs/class_webdriver_WebDriver_Navigation.html +5 -5
  10. package/docs/class_webdriver_WebDriver_Options.html +9 -9
  11. package/docs/class_webdriver_WebDriver_TargetLocator.html +6 -6
  12. package/docs/class_webdriver_WebDriver_Timeouts.html +4 -4
  13. package/docs/class_webdriver_WebDriver_Window.html +6 -6
  14. package/docs/class_webdriver_WebElement.html +23 -23
  15. package/docs/class_webdriver_WebElementPromise.html +22 -22
  16. package/docs/class_webdriver_promise_CancellationError.html +3 -0
  17. package/docs/class_webdriver_promise_ControlFlow.html +32 -32
  18. package/docs/class_webdriver_promise_Deferred.html +7 -8
  19. package/docs/class_webdriver_promise_Frame_.html +14 -30
  20. package/docs/class_webdriver_promise_Promise.html +2 -2
  21. package/docs/class_webdriver_promise_Task_.html +12 -12
  22. package/docs/class_webdriver_until_Condition.html +3 -0
  23. package/docs/enum_webdriver_Key.html +1 -1
  24. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +1 -1
  25. package/docs/enum_webdriver_promise_Deferred_State_.html +1 -1
  26. package/docs/index.html +8 -13
  27. package/docs/interface_webdriver_promise_Thenable.html +8 -10
  28. package/docs/license.html +1 -1
  29. package/docs/module_selenium-webdriver.html +2 -2
  30. package/docs/module_selenium-webdriver__base.html +1 -1
  31. package/docs/module_selenium-webdriver__base_class_Context.html +1 -1
  32. package/docs/module_selenium-webdriver_builder.html +1 -1
  33. package/docs/module_selenium-webdriver_builder_class_Builder.html +1 -1
  34. package/docs/module_selenium-webdriver_chrome.html +1 -1
  35. package/docs/module_selenium-webdriver_chrome_class_Driver.html +2 -2
  36. package/docs/module_selenium-webdriver_chrome_class_Options.html +2 -2
  37. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +1 -1
  38. package/docs/module_selenium-webdriver_error.html +1 -1
  39. package/docs/module_selenium-webdriver_executors.html +1 -1
  40. package/docs/module_selenium-webdriver_firefox.html +1 -1
  41. package/docs/module_selenium-webdriver_firefox_binary.html +1 -1
  42. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +1 -1
  43. package/docs/module_selenium-webdriver_firefox_class_Driver.html +2 -2
  44. package/docs/module_selenium-webdriver_firefox_class_Options.html +1 -1
  45. package/docs/module_selenium-webdriver_firefox_extension.html +1 -1
  46. package/docs/module_selenium-webdriver_firefox_profile.html +1 -1
  47. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +1 -1
  48. package/docs/module_selenium-webdriver_http.html +1 -1
  49. package/docs/module_selenium-webdriver_http_class_HttpClient.html +1 -1
  50. package/docs/module_selenium-webdriver_http_util.html +1 -1
  51. package/docs/module_selenium-webdriver_io.html +1 -1
  52. package/docs/module_selenium-webdriver_io_exec.html +1 -1
  53. package/docs/module_selenium-webdriver_net.html +1 -1
  54. package/docs/module_selenium-webdriver_net_portprober.html +1 -1
  55. package/docs/module_selenium-webdriver_phantomjs.html +1 -1
  56. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +2 -2
  57. package/docs/module_selenium-webdriver_proxy.html +1 -1
  58. package/docs/module_selenium-webdriver_remote.html +1 -1
  59. package/docs/module_selenium-webdriver_remote_class_DriverService.html +2 -2
  60. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +2 -2
  61. package/docs/module_selenium-webdriver_testing.html +16 -29
  62. package/docs/module_selenium-webdriver_testing_assert.html +1 -1
  63. package/docs/namespace_webdriver_promise.html +18 -20
  64. package/docs/namespace_webdriver_stacktrace.html +15 -15
  65. package/docs/namespace_webdriver_until.html +32 -0
  66. package/docs/source/_base.js.src.html +1 -1
  67. package/docs/source/builder.js.src.html +1 -1
  68. package/docs/source/chrome.js.src.html +1 -1
  69. package/docs/source/error.js.src.html +1 -1
  70. package/docs/source/executors.js.src.html +1 -1
  71. package/docs/source/firefox/binary.js.src.html +1 -1
  72. package/docs/source/firefox/extension.js.src.html +1 -1
  73. package/docs/source/firefox/index.js.src.html +1 -1
  74. package/docs/source/firefox/profile.js.src.html +1 -1
  75. package/docs/source/http/index.js.src.html +1 -1
  76. package/docs/source/http/util.js.src.html +1 -1
  77. package/docs/source/index.js.src.html +1 -1
  78. package/docs/source/io/exec.js.src.html +1 -1
  79. package/docs/source/io/index.js.src.html +1 -1
  80. package/docs/source/lib/atoms/error.js.src.html +1 -1
  81. package/docs/source/lib/atoms/json.js.src.html +1 -1
  82. package/docs/source/lib/atoms/response.js.src.html +1 -1
  83. package/docs/source/lib/atoms/userAgent.js.src.html +1 -1
  84. package/docs/source/lib/goog/array/array.js.src.html +1 -1
  85. package/docs/source/lib/goog/asserts/asserts.js.src.html +1 -1
  86. package/docs/source/lib/goog/async/nexttick.js.src.html +1 -1
  87. package/docs/source/lib/goog/async/run.js.src.html +1 -1
  88. package/docs/source/lib/goog/base.js.src.html +1 -1
  89. package/docs/source/lib/goog/debug/debug.js.src.html +1 -1
  90. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +1 -1
  91. package/docs/source/lib/goog/debug/error.js.src.html +1 -1
  92. package/docs/source/lib/goog/debug/logbuffer.js.src.html +1 -1
  93. package/docs/source/lib/goog/debug/logger.js.src.html +1 -1
  94. package/docs/source/lib/goog/debug/logrecord.js.src.html +1 -1
  95. package/docs/source/lib/goog/deps.js.src.html +1 -1
  96. package/docs/source/lib/goog/disposable/disposable.js.src.html +1 -1
  97. package/docs/source/lib/goog/disposable/idisposable.js.src.html +1 -1
  98. package/docs/source/lib/goog/dom/browserfeature.js.src.html +1 -1
  99. package/docs/source/lib/goog/dom/dom.js.src.html +1 -1
  100. package/docs/source/lib/goog/dom/nodetype.js.src.html +1 -1
  101. package/docs/source/lib/goog/dom/tagname.js.src.html +1 -1
  102. package/docs/source/lib/goog/dom/vendor.js.src.html +1 -1
  103. package/docs/source/lib/goog/events/browserevent.js.src.html +1 -1
  104. package/docs/source/lib/goog/events/browserfeature.js.src.html +1 -1
  105. package/docs/source/lib/goog/events/event.js.src.html +1 -1
  106. package/docs/source/lib/goog/events/eventid.js.src.html +1 -1
  107. package/docs/source/lib/goog/events/events.js.src.html +1 -1
  108. package/docs/source/lib/goog/events/eventtarget.js.src.html +1 -1
  109. package/docs/source/lib/goog/events/eventtype.js.src.html +1 -1
  110. package/docs/source/lib/goog/events/keycodes.js.src.html +1 -1
  111. package/docs/source/lib/goog/events/listenable.js.src.html +1 -1
  112. package/docs/source/lib/goog/events/listener.js.src.html +1 -1
  113. package/docs/source/lib/goog/events/listenermap.js.src.html +1 -1
  114. package/docs/source/lib/goog/functions/functions.js.src.html +1 -1
  115. package/docs/source/lib/goog/iter/iter.js.src.html +1 -1
  116. package/docs/source/lib/goog/json/json.js.src.html +1 -1
  117. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +1 -1
  118. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +1 -1
  119. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +1 -1
  120. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +1 -1
  121. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +1 -1
  122. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +1 -1
  123. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +1 -1
  124. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +1 -1
  125. package/docs/source/lib/goog/labs/useragent/util.js.src.html +1 -1
  126. package/docs/source/lib/goog/math/box.js.src.html +1 -1
  127. package/docs/source/lib/goog/math/coordinate.js.src.html +1 -1
  128. package/docs/source/lib/goog/math/math.js.src.html +1 -1
  129. package/docs/source/lib/goog/math/rect.js.src.html +1 -1
  130. package/docs/source/lib/goog/math/size.js.src.html +1 -1
  131. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +1 -1
  132. package/docs/source/lib/goog/net/xhrlike.js.src.html +1 -1
  133. package/docs/source/lib/goog/net/xmlhttp.js.src.html +1 -1
  134. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +1 -1
  135. package/docs/source/lib/goog/object/object.js.src.html +1 -1
  136. package/docs/source/lib/goog/reflect/reflect.js.src.html +1 -1
  137. package/docs/source/lib/goog/string/string.js.src.html +1 -1
  138. package/docs/source/lib/goog/structs/collection.js.src.html +1 -1
  139. package/docs/source/lib/goog/structs/map.js.src.html +1 -1
  140. package/docs/source/lib/goog/structs/set.js.src.html +1 -1
  141. package/docs/source/lib/goog/structs/structs.js.src.html +1 -1
  142. package/docs/source/lib/goog/style/style.js.src.html +1 -1
  143. package/docs/source/lib/goog/testing/asserts.js.src.html +1 -1
  144. package/docs/source/lib/goog/testing/asynctestcase.js.src.html +1 -1
  145. package/docs/source/lib/goog/testing/events/events.js.src.html +1 -1
  146. package/docs/source/lib/goog/testing/functionmock.js.src.html +1 -1
  147. package/docs/source/lib/goog/testing/jsunit.js.src.html +1 -1
  148. package/docs/source/lib/goog/testing/loosemock.js.src.html +1 -1
  149. package/docs/source/lib/goog/testing/mock.js.src.html +1 -1
  150. package/docs/source/lib/goog/testing/mockclock.js.src.html +1 -1
  151. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +1 -1
  152. package/docs/source/lib/goog/testing/mockinterface.js.src.html +1 -1
  153. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +1 -1
  154. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +1 -1
  155. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +1 -1
  156. package/docs/source/lib/goog/testing/recordfunction.js.src.html +1 -1
  157. package/docs/source/lib/goog/testing/stacktrace.js.src.html +1 -1
  158. package/docs/source/lib/goog/testing/strictmock.js.src.html +1 -1
  159. package/docs/source/lib/goog/testing/testcase.js.src.html +1 -1
  160. package/docs/source/lib/goog/testing/testrunner.js.src.html +1 -1
  161. package/docs/source/lib/goog/testing/watchers.js.src.html +1 -1
  162. package/docs/source/lib/goog/uri/uri.js.src.html +1 -1
  163. package/docs/source/lib/goog/uri/utils.js.src.html +1 -1
  164. package/docs/source/lib/goog/useragent/product.js.src.html +1 -1
  165. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +1 -1
  166. package/docs/source/lib/goog/useragent/useragent.js.src.html +1 -1
  167. package/docs/source/lib/webdriver/abstractbuilder.js.src.html +1 -1
  168. package/docs/source/lib/webdriver/actionsequence.js.src.html +1 -1
  169. package/docs/source/lib/webdriver/builder.js.src.html +1 -1
  170. package/docs/source/lib/webdriver/button.js.src.html +1 -1
  171. package/docs/source/lib/webdriver/capabilities.js.src.html +1 -1
  172. package/docs/source/lib/webdriver/command.js.src.html +1 -1
  173. package/docs/source/lib/webdriver/events.js.src.html +1 -1
  174. package/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html +1 -1
  175. package/docs/source/lib/webdriver/http/corsclient.js.src.html +1 -1
  176. package/docs/source/lib/webdriver/http/http.js.src.html +1 -1
  177. package/docs/source/lib/webdriver/http/xhrclient.js.src.html +1 -1
  178. package/docs/source/lib/webdriver/key.js.src.html +1 -1
  179. package/docs/source/lib/webdriver/locators.js.src.html +1 -1
  180. package/docs/source/lib/webdriver/logging.js.src.html +1 -1
  181. package/docs/source/lib/webdriver/process.js.src.html +1 -1
  182. package/docs/source/lib/webdriver/promise.js.src.html +1 -1
  183. package/docs/source/lib/webdriver/session.js.src.html +1 -1
  184. package/docs/source/lib/webdriver/stacktrace.js.src.html +1 -1
  185. package/docs/source/lib/webdriver/testing/asserts.js.src.html +1 -1
  186. package/docs/source/lib/webdriver/testing/testcase.js.src.html +1 -1
  187. package/docs/source/lib/webdriver/until.js.src.html +1 -0
  188. package/docs/source/lib/webdriver/webdriver.js.src.html +1 -1
  189. package/docs/source/net/index.js.src.html +1 -1
  190. package/docs/source/net/portprober.js.src.html +1 -1
  191. package/docs/source/phantomjs.js.src.html +1 -1
  192. package/docs/source/proxy.js.src.html +1 -1
  193. package/docs/source/remote/index.js.src.html +1 -1
  194. package/docs/source/testing/assert.js.src.html +1 -1
  195. package/docs/source/testing/index.js.src.html +1 -1
  196. package/docs/types.js +1 -1
  197. package/example/google_search.js +9 -17
  198. package/example/google_search_generator.js +6 -7
  199. package/example/google_search_test.js +10 -18
  200. package/example/parallel_flows.js +4 -7
  201. package/index.js +6 -0
  202. package/lib/firefox/webdriver.xpi +0 -0
  203. package/lib/goog/deps.js +7 -5
  204. package/lib/test/index.js +0 -8
  205. package/lib/webdriver/promise.js +263 -251
  206. package/lib/webdriver/stacktrace.js +15 -1
  207. package/lib/webdriver/test/promise_flow_test.js +82 -76
  208. package/lib/webdriver/test/promise_test.js +22 -62
  209. package/lib/webdriver/test/stacktrace_test.js +18 -0
  210. package/lib/webdriver/test/until_test.js +388 -0
  211. package/lib/webdriver/test/webdriver_test.js +41 -0
  212. package/lib/webdriver/until.js +408 -0
  213. package/lib/webdriver/webdriver.js +91 -29
  214. package/package.json +2 -2
  215. package/test/element_finding_test.js +6 -6
  216. package/test/http/util_test.js +4 -5
  217. package/test/page_loading_test.js +7 -7
  218. package/test/stale_element_test.js +2 -10
  219. package/testing/index.js +9 -22
package/docs/source/lib/goog/testing/asynctestcase.js.src.html CHANGED
@@ -1 +1 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>asynctestcase.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/testing/asynctestcase.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td>// All Rights Reserved.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview A class representing a set of test functions that use<tr><td><a name="l18" href="#l18">18</a><td> * asynchronous functions that cannot be meaningfully mocked.<tr><td><a name="l19" href="#l19">19</a><td> *<tr><td><a name="l20" href="#l20">20</a><td> * To create a Google-compatable JsUnit test using this test case, put the<tr><td><a name="l21" href="#l21">21</a><td> * following snippet in your test:<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l24" href="#l24">24</a><td> *<tr><td><a name="l25" href="#l25">25</a><td> * To make the test runner wait for your asynchronous behaviour, use:<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> * asyncTestCase.waitForAsync(&#39;Waiting for xhr to respond&#39;);<tr><td><a name="l28" href="#l28">28</a><td> *<tr><td><a name="l29" href="#l29">29</a><td> * The next test will not start until the following call is made, or a<tr><td><a name="l30" href="#l30">30</a><td> * timeout occurs:<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l33" href="#l33">33</a><td> *<tr><td><a name="l34" href="#l34">34</a><td> * There does NOT need to be a 1:1 mapping of waitForAsync calls and<tr><td><a name="l35" href="#l35">35</a><td> * continueTesting calls. The next test will be run after a single call to<tr><td><a name="l36" href="#l36">36</a><td> * continueTesting is made, as long as there is no subsequent call to<tr><td><a name="l37" href="#l37">37</a><td> * waitForAsync in the same thread.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * Example:<tr><td><a name="l40" href="#l40">40</a><td> * // Returning here would cause the next test to be run.<tr><td><a name="l41" href="#l41">41</a><td> * asyncTestCase.waitForAsync(&#39;description 1&#39;);<tr><td><a name="l42" href="#l42">42</a><td> * // Returning here would *not* cause the next test to be run.<tr><td><a name="l43" href="#l43">43</a><td> * // Only effect of additional waitForAsync() calls is an updated<tr><td><a name="l44" href="#l44">44</a><td> * // description in the case of a timeout.<tr><td><a name="l45" href="#l45">45</a><td> * asyncTestCase.waitForAsync(&#39;updated description&#39;);<tr><td><a name="l46" href="#l46">46</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l47" href="#l47">47</a><td> * // Returning here would cause the next test to be run.<tr><td><a name="l48" href="#l48">48</a><td> * asyncTestCase.waitForAsync(&#39;just kidding, still running.&#39;);<tr><td><a name="l49" href="#l49">49</a><td> * // Returning here would *not* cause the next test to be run.<tr><td><a name="l50" href="#l50">50</a><td> *<tr><td><a name="l51" href="#l51">51</a><td> * The test runner can also be made to wait for more than one asynchronous<tr><td><a name="l52" href="#l52">52</a><td> * event with:<tr><td><a name="l53" href="#l53">53</a><td> *<tr><td><a name="l54" href="#l54">54</a><td> * asyncTestCase.waitForSignals(n);<tr><td><a name="l55" href="#l55">55</a><td> *<tr><td><a name="l56" href="#l56">56</a><td> * The next test will not start until asyncTestCase.signal() is called n times,<tr><td><a name="l57" href="#l57">57</a><td> * or the test step timeout is exceeded.<tr><td><a name="l58" href="#l58">58</a><td> *<tr><td><a name="l59" href="#l59">59</a><td> * This class supports asynchronous behaviour in all test functions except for<tr><td><a name="l60" href="#l60">60</a><td> * tearDownPage. If such support is needed, it can be added.<tr><td><a name="l61" href="#l61">61</a><td> *<tr><td><a name="l62" href="#l62">62</a><td> * Example Usage:<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l65" href="#l65">65</a><td> * // Optionally, set a longer-than-normal step timeout.<tr><td><a name="l66" href="#l66">66</a><td> * asyncTestCase.stepTimeout = 30 * 1000;<tr><td><a name="l67" href="#l67">67</a><td> *<tr><td><a name="l68" href="#l68">68</a><td> * function testSetTimeout() {<tr><td><a name="l69" href="#l69">69</a><td> * var step = 0;<tr><td><a name="l70" href="#l70">70</a><td> * function stepCallback() {<tr><td><a name="l71" href="#l71">71</a><td> * step++;<tr><td><a name="l72" href="#l72">72</a><td> * switch (step) {<tr><td><a name="l73" href="#l73">73</a><td> * case 1:<tr><td><a name="l74" href="#l74">74</a><td> * var startTime = goog.now();<tr><td><a name="l75" href="#l75">75</a><td> * asyncTestCase.waitForAsync(&#39;step 1&#39;);<tr><td><a name="l76" href="#l76">76</a><td> * window.setTimeout(stepCallback, 100);<tr><td><a name="l77" href="#l77">77</a><td> * break;<tr><td><a name="l78" href="#l78">78</a><td> * case 2:<tr><td><a name="l79" href="#l79">79</a><td> * assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l80" href="#l80">80</a><td> * goog.now() - startTime &gt;= 100);<tr><td><a name="l81" href="#l81">81</a><td> * asyncTestCase.waitForAsync(&#39;step 2&#39;);<tr><td><a name="l82" href="#l82">82</a><td> * window.setTimeout(stepCallback, 100);<tr><td><a name="l83" href="#l83">83</a><td> * break;<tr><td><a name="l84" href="#l84">84</a><td> * case 3:<tr><td><a name="l85" href="#l85">85</a><td> * assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l86" href="#l86">86</a><td> * goog.now() - startTime &gt;= 200);<tr><td><a name="l87" href="#l87">87</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l88" href="#l88">88</a><td> * break;<tr><td><a name="l89" href="#l89">89</a><td> * default:<tr><td><a name="l90" href="#l90">90</a><td> * fail(&#39;Unexpected call to stepCallback&#39;);<tr><td><a name="l91" href="#l91">91</a><td> * }<tr><td><a name="l92" href="#l92">92</a><td> * }<tr><td><a name="l93" href="#l93">93</a><td> * stepCallback();<tr><td><a name="l94" href="#l94">94</a><td> * }<tr><td><a name="l95" href="#l95">95</a><td> *<tr><td><a name="l96" href="#l96">96</a><td> * Known Issues:<tr><td><a name="l97" href="#l97">97</a><td> * IE7 Exceptions:<tr><td><a name="l98" href="#l98">98</a><td> * As the failingtest.html will show, it appears as though ie7 does not<tr><td><a name="l99" href="#l99">99</a><td> * propagate an exception past a function called using the func.call()<tr><td><a name="l100" href="#l100">100</a><td> * syntax. This causes case 3 of the failing tests (exceptions) to show up<tr><td><a name="l101" href="#l101">101</a><td> * as timeouts in IE.<tr><td><a name="l102" href="#l102">102</a><td> * window.onerror:<tr><td><a name="l103" href="#l103">103</a><td> * This seems to catch errors only in ff2/ff3. It does not work in Safari or<tr><td><a name="l104" href="#l104">104</a><td> * IE7. The consequence of this is that exceptions that would have been<tr><td><a name="l105" href="#l105">105</a><td> * caught by window.onerror show up as timeouts.<tr><td><a name="l106" href="#l106">106</a><td> *<tr><td><a name="l107" href="#l107">107</a><td> * @author agrieve@google.com (Andrew Grieve)<tr><td><a name="l108" href="#l108">108</a><td> */<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>goog.provide(&#39;goog.testing.AsyncTestCase&#39;);<tr><td><a name="l111" href="#l111">111</a><td>goog.provide(&#39;goog.testing.AsyncTestCase.ControlBreakingException&#39;);<tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<tr><td><a name="l114" href="#l114">114</a><td>goog.require(&#39;goog.testing.TestCase.Test&#39;);<tr><td><a name="l115" href="#l115">115</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/**<tr><td><a name="l120" href="#l120">120</a><td> * A test case that is capable of running tests the contain asynchronous logic.<tr><td><a name="l121" href="#l121">121</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l122" href="#l122">122</a><td> * @extends {goog.testing.TestCase}<tr><td><a name="l123" href="#l123">123</a><td> * @constructor<tr><td><a name="l124" href="#l124">124</a><td> */<tr><td><a name="l125" href="#l125">125</a><td>goog.testing.AsyncTestCase = function(opt_name) {<tr><td><a name="l126" href="#l126">126</a><td> goog.testing.TestCase.call(this, opt_name);<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td>goog.inherits(goog.testing.AsyncTestCase, goog.testing.TestCase);<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * Represents result of top stack function call.<tr><td><a name="l133" href="#l133">133</a><td> * @typedef {{controlBreakingExceptionThrown: boolean, message: string}}<tr><td><a name="l134" href="#l134">134</a><td> * @private<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.testing.AsyncTestCase.TopStackFuncResult_;<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>/**<tr><td><a name="l141" href="#l141">141</a><td> * An exception class used solely for control flow.<tr><td><a name="l142" href="#l142">142</a><td> * @param {string=} opt_message Error message.<tr><td><a name="l143" href="#l143">143</a><td> * @constructor<tr><td><a name="l144" href="#l144">144</a><td> * @final<tr><td><a name="l145" href="#l145">145</a><td> */<tr><td><a name="l146" href="#l146">146</a><td>goog.testing.AsyncTestCase.ControlBreakingException = function(opt_message) {<tr><td><a name="l147" href="#l147">147</a><td> /**<tr><td><a name="l148" href="#l148">148</a><td> * The exception message.<tr><td><a name="l149" href="#l149">149</a><td> * @type {string}<tr><td><a name="l150" href="#l150">150</a><td> */<tr><td><a name="l151" href="#l151">151</a><td> this.message = opt_message || &#39;&#39;;<tr><td><a name="l152" href="#l152">152</a><td>};<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * Return value for .toString().<tr><td><a name="l157" href="#l157">157</a><td> * @type {string}<tr><td><a name="l158" href="#l158">158</a><td> */<tr><td><a name="l159" href="#l159">159</a><td>goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING =<tr><td><a name="l160" href="#l160">160</a><td> &#39;[AsyncTestCase.ControlBreakingException]&#39;;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td>/**<tr><td><a name="l164" href="#l164">164</a><td> * Marks this object as a ControlBreakingException<tr><td><a name="l165" href="#l165">165</a><td> * @type {boolean}<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.<tr><td><a name="l168" href="#l168">168</a><td> isControlBreakingException = true;<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/** @override */<tr><td><a name="l172" href="#l172">172</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.toString =<tr><td><a name="l173" href="#l173">173</a><td> function() {<tr><td><a name="l174" href="#l174">174</a><td> // This shows up in the console when the exception is not caught.<tr><td><a name="l175" href="#l175">175</a><td> return goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l176" href="#l176">176</a><td>};<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * How long to wait for a single step of a test to complete in milliseconds.<tr><td><a name="l181" href="#l181">181</a><td> * A step starts when a call to waitForAsync() is made.<tr><td><a name="l182" href="#l182">182</a><td> * @type {number}<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>goog.testing.AsyncTestCase.prototype.stepTimeout = 1000;<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * How long to wait after a failed test before moving onto the next one.<tr><td><a name="l189" href="#l189">189</a><td> * The purpose of this is to allow any pending async callbacks from the failing<tr><td><a name="l190" href="#l190">190</a><td> * test to finish up and not cause the next test to fail.<tr><td><a name="l191" href="#l191">191</a><td> * @type {number}<tr><td><a name="l192" href="#l192">192</a><td> */<tr><td><a name="l193" href="#l193">193</a><td>goog.testing.AsyncTestCase.prototype.timeToSleepAfterFailure = 500;<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td><tr><td><a name="l196" href="#l196">196</a><td>/**<tr><td><a name="l197" href="#l197">197</a><td> * Turn on extra logging to help debug failing async. tests.<tr><td><a name="l198" href="#l198">198</a><td> * @type {boolean}<tr><td><a name="l199" href="#l199">199</a><td> * @private<tr><td><a name="l200" href="#l200">200</a><td> */<tr><td><a name="l201" href="#l201">201</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogs_ = false;<tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td>/**<tr><td><a name="l205" href="#l205">205</a><td> * A reference to the original asserts.js assert_() function.<tr><td><a name="l206" href="#l206">206</a><td> * @private<tr><td><a name="l207" href="#l207">207</a><td> */<tr><td><a name="l208" href="#l208">208</a><td>goog.testing.AsyncTestCase.prototype.origAssert_;<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td>/**<tr><td><a name="l212" href="#l212">212</a><td> * A reference to the original asserts.js fail() function.<tr><td><a name="l213" href="#l213">213</a><td> * @private<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.testing.AsyncTestCase.prototype.origFail_;<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * A reference to the original window.onerror function.<tr><td><a name="l220" href="#l220">220</a><td> * @type {Function|undefined}<tr><td><a name="l221" href="#l221">221</a><td> * @private<tr><td><a name="l222" href="#l222">222</a><td> */<tr><td><a name="l223" href="#l223">223</a><td>goog.testing.AsyncTestCase.prototype.origOnError_;<tr><td><a name="l224" href="#l224">224</a><td><tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>/**<tr><td><a name="l227" href="#l227">227</a><td> * The stage of the test we are currently on.<tr><td><a name="l228" href="#l228">228</a><td> * @type {Function|undefined}}<tr><td><a name="l229" href="#l229">229</a><td> * @private<tr><td><a name="l230" href="#l230">230</a><td> */<tr><td><a name="l231" href="#l231">231</a><td>goog.testing.AsyncTestCase.prototype.curStepFunc_;<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * The name of the stage of the test we are currently on.<tr><td><a name="l236" href="#l236">236</a><td> * @type {string}<tr><td><a name="l237" href="#l237">237</a><td> * @private<tr><td><a name="l238" href="#l238">238</a><td> */<tr><td><a name="l239" href="#l239">239</a><td>goog.testing.AsyncTestCase.prototype.curStepName_ = &#39;&#39;;<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>/**<tr><td><a name="l243" href="#l243">243</a><td> * The stage of the test we should run next.<tr><td><a name="l244" href="#l244">244</a><td> * @type {Function|undefined}<tr><td><a name="l245" href="#l245">245</a><td> * @private<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>goog.testing.AsyncTestCase.prototype.nextStepFunc;<tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>/**<tr><td><a name="l251" href="#l251">251</a><td> * The name of the stage of the test we should run next.<tr><td><a name="l252" href="#l252">252</a><td> * @type {string}<tr><td><a name="l253" href="#l253">253</a><td> * @private<tr><td><a name="l254" href="#l254">254</a><td> */<tr><td><a name="l255" href="#l255">255</a><td>goog.testing.AsyncTestCase.prototype.nextStepName_ = &#39;&#39;;<tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>/**<tr><td><a name="l259" href="#l259">259</a><td> * The handle to the current setTimeout timer.<tr><td><a name="l260" href="#l260">260</a><td> * @type {number}<tr><td><a name="l261" href="#l261">261</a><td> * @private<tr><td><a name="l262" href="#l262">262</a><td> */<tr><td><a name="l263" href="#l263">263</a><td>goog.testing.AsyncTestCase.prototype.timeoutHandle_ = 0;<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td>/**<tr><td><a name="l267" href="#l267">267</a><td> * Marks if the cleanUp() function has been called for the currently running<tr><td><a name="l268" href="#l268">268</a><td> * test.<tr><td><a name="l269" href="#l269">269</a><td> * @type {boolean}<tr><td><a name="l270" href="#l270">270</a><td> * @private<tr><td><a name="l271" href="#l271">271</a><td> */<tr><td><a name="l272" href="#l272">272</a><td>goog.testing.AsyncTestCase.prototype.cleanedUp_ = false;<tr><td><a name="l273" href="#l273">273</a><td><tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td>/**<tr><td><a name="l276" href="#l276">276</a><td> * The currently active test.<tr><td><a name="l277" href="#l277">277</a><td> * @type {goog.testing.TestCase.Test|undefined}<tr><td><a name="l278" href="#l278">278</a><td> * @protected<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td>goog.testing.AsyncTestCase.prototype.activeTest;<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * A flag to prevent recursive exception handling.<tr><td><a name="l285" href="#l285">285</a><td> * @type {boolean}<tr><td><a name="l286" href="#l286">286</a><td> * @private<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td>goog.testing.AsyncTestCase.prototype.inException_ = false;<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td>/**<tr><td><a name="l292" href="#l292">292</a><td> * Flag used to determine if we can move to the next step in the testing loop.<tr><td><a name="l293" href="#l293">293</a><td> * @type {boolean}<tr><td><a name="l294" href="#l294">294</a><td> * @private<tr><td><a name="l295" href="#l295">295</a><td> */<tr><td><a name="l296" href="#l296">296</a><td>goog.testing.AsyncTestCase.prototype.isReady_ = true;<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>/**<tr><td><a name="l300" href="#l300">300</a><td> * Number of signals to wait for before continuing testing when waitForSignals<tr><td><a name="l301" href="#l301">301</a><td> * is used.<tr><td><a name="l302" href="#l302">302</a><td> * @type {number}<tr><td><a name="l303" href="#l303">303</a><td> * @private<tr><td><a name="l304" href="#l304">304</a><td> */<tr><td><a name="l305" href="#l305">305</a><td>goog.testing.AsyncTestCase.prototype.expectedSignalCount_ = 0;<tr><td><a name="l306" href="#l306">306</a><td><tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td>/**<tr><td><a name="l309" href="#l309">309</a><td> * Number of signals received.<tr><td><a name="l310" href="#l310">310</a><td> * @type {number}<tr><td><a name="l311" href="#l311">311</a><td> * @private<tr><td><a name="l312" href="#l312">312</a><td> */<tr><td><a name="l313" href="#l313">313</a><td>goog.testing.AsyncTestCase.prototype.receivedSignalCount_ = 0;<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td>/**<tr><td><a name="l317" href="#l317">317</a><td> * Flag that tells us if there is a function in the call stack that will make<tr><td><a name="l318" href="#l318">318</a><td> * a call to pump_().<tr><td><a name="l319" href="#l319">319</a><td> * @type {boolean}<tr><td><a name="l320" href="#l320">320</a><td> * @private<tr><td><a name="l321" href="#l321">321</a><td> */<tr><td><a name="l322" href="#l322">322</a><td>goog.testing.AsyncTestCase.prototype.returnWillPump_ = false;<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td><tr><td><a name="l325" href="#l325">325</a><td>/**<tr><td><a name="l326" href="#l326">326</a><td> * The number of times we have thrown a ControlBreakingException so that we<tr><td><a name="l327" href="#l327">327</a><td> * know not to complain in our window.onerror handler. In Webkit, window.onerror<tr><td><a name="l328" href="#l328">328</a><td> * is not supported, and so this counter will keep going up but we won&#39;t care<tr><td><a name="l329" href="#l329">329</a><td> * about it.<tr><td><a name="l330" href="#l330">330</a><td> * @type {number}<tr><td><a name="l331" href="#l331">331</a><td> * @private<tr><td><a name="l332" href="#l332">332</a><td> */<tr><td><a name="l333" href="#l333">333</a><td>goog.testing.AsyncTestCase.prototype.numControlExceptionsExpected_ = 0;<tr><td><a name="l334" href="#l334">334</a><td><tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td>/**<tr><td><a name="l337" href="#l337">337</a><td> * The current step name.<tr><td><a name="l338" href="#l338">338</a><td> * @return {!string} Step name.<tr><td><a name="l339" href="#l339">339</a><td> * @protected<tr><td><a name="l340" href="#l340">340</a><td> */<tr><td><a name="l341" href="#l341">341</a><td>goog.testing.AsyncTestCase.prototype.getCurrentStepName = function() {<tr><td><a name="l342" href="#l342">342</a><td> return this.curStepName_;<tr><td><a name="l343" href="#l343">343</a><td>};<tr><td><a name="l344" href="#l344">344</a><td><tr><td><a name="l345" href="#l345">345</a><td><tr><td><a name="l346" href="#l346">346</a><td>/**<tr><td><a name="l347" href="#l347">347</a><td> * Preferred way of creating an AsyncTestCase. Creates one and initializes it<tr><td><a name="l348" href="#l348">348</a><td> * with the G_testRunner.<tr><td><a name="l349" href="#l349">349</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l350" href="#l350">350</a><td> * @return {!goog.testing.AsyncTestCase} The created AsyncTestCase.<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.testing.AsyncTestCase.createAndInstall = function(opt_name) {<tr><td><a name="l353" href="#l353">353</a><td> var asyncTestCase = new goog.testing.AsyncTestCase(opt_name);<tr><td><a name="l354" href="#l354">354</a><td> goog.testing.TestCase.initializeTestRunner(asyncTestCase);<tr><td><a name="l355" href="#l355">355</a><td> return asyncTestCase;<tr><td><a name="l356" href="#l356">356</a><td>};<tr><td><a name="l357" href="#l357">357</a><td><tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td>/**<tr><td><a name="l360" href="#l360">360</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l361" href="#l361">361</a><td> * until continueTesting is called.<tr><td><a name="l362" href="#l362">362</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l363" href="#l363">363</a><td> */<tr><td><a name="l364" href="#l364">364</a><td>goog.testing.AsyncTestCase.prototype.waitForAsync = function(opt_name) {<tr><td><a name="l365" href="#l365">365</a><td> this.isReady_ = false;<tr><td><a name="l366" href="#l366">366</a><td> this.curStepName_ = opt_name || this.curStepName_;<tr><td><a name="l367" href="#l367">367</a><td><tr><td><a name="l368" href="#l368">368</a><td> // Reset the timer that tracks if the async test takes too long.<tr><td><a name="l369" href="#l369">369</a><td> this.stopTimeoutTimer_();<tr><td><a name="l370" href="#l370">370</a><td> this.startTimeoutTimer_();<tr><td><a name="l371" href="#l371">371</a><td>};<tr><td><a name="l372" href="#l372">372</a><td><tr><td><a name="l373" href="#l373">373</a><td><tr><td><a name="l374" href="#l374">374</a><td>/**<tr><td><a name="l375" href="#l375">375</a><td> * Continue with the next step in the test cycle.<tr><td><a name="l376" href="#l376">376</a><td> */<tr><td><a name="l377" href="#l377">377</a><td>goog.testing.AsyncTestCase.prototype.continueTesting = function() {<tr><td><a name="l378" href="#l378">378</a><td> if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l379" href="#l379">379</a><td> var remaining = this.expectedSignalCount_ - this.receivedSignalCount_;<tr><td><a name="l380" href="#l380">380</a><td> throw Error(&#39;Still waiting for &#39; + remaining + &#39; signals.&#39;);<tr><td><a name="l381" href="#l381">381</a><td> }<tr><td><a name="l382" href="#l382">382</a><td> this.endCurrentStep_();<tr><td><a name="l383" href="#l383">383</a><td>};<tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>/**<tr><td><a name="l387" href="#l387">387</a><td> * Ends the current test step and queues the next test step to run.<tr><td><a name="l388" href="#l388">388</a><td> * @private<tr><td><a name="l389" href="#l389">389</a><td> */<tr><td><a name="l390" href="#l390">390</a><td>goog.testing.AsyncTestCase.prototype.endCurrentStep_ = function() {<tr><td><a name="l391" href="#l391">391</a><td> if (!this.isReady_) {<tr><td><a name="l392" href="#l392">392</a><td> // We are a potential entry point, so we pump.<tr><td><a name="l393" href="#l393">393</a><td> this.isReady_ = true;<tr><td><a name="l394" href="#l394">394</a><td> this.stopTimeoutTimer_();<tr><td><a name="l395" href="#l395">395</a><td> // Run this in a setTimeout so that the caller has a chance to call<tr><td><a name="l396" href="#l396">396</a><td> // waitForAsync() again before we continue.<tr><td><a name="l397" href="#l397">397</a><td> this.timeout(goog.bind(this.pump_, this, null), 0);<tr><td><a name="l398" href="#l398">398</a><td> }<tr><td><a name="l399" href="#l399">399</a><td>};<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td><tr><td><a name="l402" href="#l402">402</a><td>/**<tr><td><a name="l403" href="#l403">403</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l404" href="#l404">404</a><td> * until signal is called the specified number of times. Within a test, this<tr><td><a name="l405" href="#l405">405</a><td> * function behaves additively if called multiple times; the number of signals<tr><td><a name="l406" href="#l406">406</a><td> * to wait for will be the sum of all expected number of signals this function<tr><td><a name="l407" href="#l407">407</a><td> * was called with.<tr><td><a name="l408" href="#l408">408</a><td> * @param {number} times The number of signals to receive before<tr><td><a name="l409" href="#l409">409</a><td> * continuing testing.<tr><td><a name="l410" href="#l410">410</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l411" href="#l411">411</a><td> */<tr><td><a name="l412" href="#l412">412</a><td>goog.testing.AsyncTestCase.prototype.waitForSignals =<tr><td><a name="l413" href="#l413">413</a><td> function(times, opt_name) {<tr><td><a name="l414" href="#l414">414</a><td> this.expectedSignalCount_ += times;<tr><td><a name="l415" href="#l415">415</a><td> if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l416" href="#l416">416</a><td> this.waitForAsync(opt_name);<tr><td><a name="l417" href="#l417">417</a><td> }<tr><td><a name="l418" href="#l418">418</a><td>};<tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td>/**<tr><td><a name="l422" href="#l422">422</a><td> * Signals once to continue with the test. If this is the last signal that the<tr><td><a name="l423" href="#l423">423</a><td> * test was waiting on, call continueTesting.<tr><td><a name="l424" href="#l424">424</a><td> */<tr><td><a name="l425" href="#l425">425</a><td>goog.testing.AsyncTestCase.prototype.signal = function() {<tr><td><a name="l426" href="#l426">426</a><td> if (++this.receivedSignalCount_ === this.expectedSignalCount_ &amp;&amp;<tr><td><a name="l427" href="#l427">427</a><td> this.expectedSignalCount_ &gt; 0) {<tr><td><a name="l428" href="#l428">428</a><td> this.endCurrentStep_();<tr><td><a name="l429" href="#l429">429</a><td> }<tr><td><a name="l430" href="#l430">430</a><td>};<tr><td><a name="l431" href="#l431">431</a><td><tr><td><a name="l432" href="#l432">432</a><td><tr><td><a name="l433" href="#l433">433</a><td>/**<tr><td><a name="l434" href="#l434">434</a><td> * Handles an exception thrown by a test.<tr><td><a name="l435" href="#l435">435</a><td> * @param {*=} opt_e The exception object associated with the failure<tr><td><a name="l436" href="#l436">436</a><td> * or a string.<tr><td><a name="l437" href="#l437">437</a><td> * @throws Always throws a ControlBreakingException.<tr><td><a name="l438" href="#l438">438</a><td> */<tr><td><a name="l439" href="#l439">439</a><td>goog.testing.AsyncTestCase.prototype.doAsyncError = function(opt_e) {<tr><td><a name="l440" href="#l440">440</a><td> // If we&#39;ve caught an exception that we threw, then just pass it along. This<tr><td><a name="l441" href="#l441">441</a><td> // can happen if doAsyncError() was called from a call to assert and then<tr><td><a name="l442" href="#l442">442</a><td> // again by pump_().<tr><td><a name="l443" href="#l443">443</a><td> if (opt_e &amp;&amp; opt_e.isControlBreakingException) {<tr><td><a name="l444" href="#l444">444</a><td> throw opt_e;<tr><td><a name="l445" href="#l445">445</a><td> }<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td> // Prevent another timeout error from triggering for this test step.<tr><td><a name="l448" href="#l448">448</a><td> this.stopTimeoutTimer_();<tr><td><a name="l449" href="#l449">449</a><td><tr><td><a name="l450" href="#l450">450</a><td> // doError() uses test.name. Here, we create a dummy test and give it a more<tr><td><a name="l451" href="#l451">451</a><td> // helpful name based on the step we&#39;re currently on.<tr><td><a name="l452" href="#l452">452</a><td> var fakeTestObj = new goog.testing.TestCase.Test(this.curStepName_,<tr><td><a name="l453" href="#l453">453</a><td> goog.nullFunction);<tr><td><a name="l454" href="#l454">454</a><td> if (this.activeTest) {<tr><td><a name="l455" href="#l455">455</a><td> fakeTestObj.name = this.activeTest.name + &#39; [&#39; + fakeTestObj.name + &#39;]&#39;;<tr><td><a name="l456" href="#l456">456</a><td> }<tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td> if (this.activeTest) {<tr><td><a name="l459" href="#l459">459</a><td> // Note: if the test has an error, and then tearDown has an error, they will<tr><td><a name="l460" href="#l460">460</a><td> // both be reported.<tr><td><a name="l461" href="#l461">461</a><td> this.doError(fakeTestObj, opt_e);<tr><td><a name="l462" href="#l462">462</a><td> } else {<tr><td><a name="l463" href="#l463">463</a><td> this.exceptionBeforeTest = opt_e;<tr><td><a name="l464" href="#l464">464</a><td> }<tr><td><a name="l465" href="#l465">465</a><td><tr><td><a name="l466" href="#l466">466</a><td> // This is a potential entry point, so we pump. We also add in a bit of a<tr><td><a name="l467" href="#l467">467</a><td> // delay to try and prevent any async behavior from the failed test from<tr><td><a name="l468" href="#l468">468</a><td> // causing the next test to fail.<tr><td><a name="l469" href="#l469">469</a><td> this.timeout(goog.bind(this.pump_, this, this.doAsyncErrorTearDown_),<tr><td><a name="l470" href="#l470">470</a><td> this.timeToSleepAfterFailure);<tr><td><a name="l471" href="#l471">471</a><td><tr><td><a name="l472" href="#l472">472</a><td> // We just caught an exception, so we do not want the code above us on the<tr><td><a name="l473" href="#l473">473</a><td> // stack to continue executing. If pump_ is in our call-stack, then it will<tr><td><a name="l474" href="#l474">474</a><td> // batch together multiple errors, so we only increment the count if pump_ is<tr><td><a name="l475" href="#l475">475</a><td> // not in the stack and let pump_ increment the count when it batches them.<tr><td><a name="l476" href="#l476">476</a><td> if (!this.returnWillPump_) {<tr><td><a name="l477" href="#l477">477</a><td> this.numControlExceptionsExpected_ += 1;<tr><td><a name="l478" href="#l478">478</a><td> this.dbgLog_(&#39;doAsynError: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l479" href="#l479">479</a><td> this.numControlExceptionsExpected_ + &#39; and throwing exception.&#39;);<tr><td><a name="l480" href="#l480">480</a><td> }<tr><td><a name="l481" href="#l481">481</a><td><tr><td><a name="l482" href="#l482">482</a><td> // Copy the error message to ControlBreakingException.<tr><td><a name="l483" href="#l483">483</a><td> var message = &#39;&#39;;<tr><td><a name="l484" href="#l484">484</a><td> if (typeof opt_e == &#39;string&#39;) {<tr><td><a name="l485" href="#l485">485</a><td> message = opt_e;<tr><td><a name="l486" href="#l486">486</a><td> } else if (opt_e &amp;&amp; opt_e.message) {<tr><td><a name="l487" href="#l487">487</a><td> message = opt_e.message;<tr><td><a name="l488" href="#l488">488</a><td> }<tr><td><a name="l489" href="#l489">489</a><td> throw new goog.testing.AsyncTestCase.ControlBreakingException(message);<tr><td><a name="l490" href="#l490">490</a><td>};<tr><td><a name="l491" href="#l491">491</a><td><tr><td><a name="l492" href="#l492">492</a><td><tr><td><a name="l493" href="#l493">493</a><td>/**<tr><td><a name="l494" href="#l494">494</a><td> * Sets up the test page and then waits until the test case has been marked<tr><td><a name="l495" href="#l495">495</a><td> * as ready before executing the tests.<tr><td><a name="l496" href="#l496">496</a><td> * @override<tr><td><a name="l497" href="#l497">497</a><td> */<tr><td><a name="l498" href="#l498">498</a><td>goog.testing.AsyncTestCase.prototype.runTests = function() {<tr><td><a name="l499" href="#l499">499</a><td> this.hookAssert_();<tr><td><a name="l500" href="#l500">500</a><td> this.hookOnError_();<tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td> this.setNextStep_(this.doSetUpPage_, &#39;setUpPage&#39;);<tr><td><a name="l503" href="#l503">503</a><td> // We are an entry point, so we pump.<tr><td><a name="l504" href="#l504">504</a><td> this.pump_();<tr><td><a name="l505" href="#l505">505</a><td>};<tr><td><a name="l506" href="#l506">506</a><td><tr><td><a name="l507" href="#l507">507</a><td><tr><td><a name="l508" href="#l508">508</a><td>/**<tr><td><a name="l509" href="#l509">509</a><td> * Starts the tests.<tr><td><a name="l510" href="#l510">510</a><td> * @override<tr><td><a name="l511" href="#l511">511</a><td> */<tr><td><a name="l512" href="#l512">512</a><td>goog.testing.AsyncTestCase.prototype.cycleTests = function() {<tr><td><a name="l513" href="#l513">513</a><td> // We are an entry point, so we pump.<tr><td><a name="l514" href="#l514">514</a><td> this.saveMessage(&#39;Start&#39;);<tr><td><a name="l515" href="#l515">515</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l516" href="#l516">516</a><td> this.pump_();<tr><td><a name="l517" href="#l517">517</a><td>};<tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td><tr><td><a name="l520" href="#l520">520</a><td>/**<tr><td><a name="l521" href="#l521">521</a><td> * Finalizes the test case, called when the tests have finished executing.<tr><td><a name="l522" href="#l522">522</a><td> * @override<tr><td><a name="l523" href="#l523">523</a><td> */<tr><td><a name="l524" href="#l524">524</a><td>goog.testing.AsyncTestCase.prototype.finalize = function() {<tr><td><a name="l525" href="#l525">525</a><td> this.unhookAll_();<tr><td><a name="l526" href="#l526">526</a><td> this.setNextStep_(null, &#39;finalized&#39;);<tr><td><a name="l527" href="#l527">527</a><td> goog.testing.AsyncTestCase.superClass_.finalize.call(this);<tr><td><a name="l528" href="#l528">528</a><td>};<tr><td><a name="l529" href="#l529">529</a><td><tr><td><a name="l530" href="#l530">530</a><td><tr><td><a name="l531" href="#l531">531</a><td>/**<tr><td><a name="l532" href="#l532">532</a><td> * Enables verbose logging of what is happening inside of the AsyncTestCase.<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogging = function() {<tr><td><a name="l535" href="#l535">535</a><td> this.enableDebugLogs_ = true;<tr><td><a name="l536" href="#l536">536</a><td>};<tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td><tr><td><a name="l539" href="#l539">539</a><td>/**<tr><td><a name="l540" href="#l540">540</a><td> * Logs the given debug message to the console (when enabled).<tr><td><a name="l541" href="#l541">541</a><td> * @param {string} message The message to log.<tr><td><a name="l542" href="#l542">542</a><td> * @private<tr><td><a name="l543" href="#l543">543</a><td> */<tr><td><a name="l544" href="#l544">544</a><td>goog.testing.AsyncTestCase.prototype.dbgLog_ = function(message) {<tr><td><a name="l545" href="#l545">545</a><td> if (this.enableDebugLogs_) {<tr><td><a name="l546" href="#l546">546</a><td> this.log(&#39;AsyncTestCase - &#39; + message);<tr><td><a name="l547" href="#l547">547</a><td> }<tr><td><a name="l548" href="#l548">548</a><td>};<tr><td><a name="l549" href="#l549">549</a><td><tr><td><a name="l550" href="#l550">550</a><td><tr><td><a name="l551" href="#l551">551</a><td>/**<tr><td><a name="l552" href="#l552">552</a><td> * Wraps doAsyncError() for when we are sure that the test runner has no user<tr><td><a name="l553" href="#l553">553</a><td> * code above it in the stack.<tr><td><a name="l554" href="#l554">554</a><td> * @param {string|Error=} opt_e The exception object associated with the<tr><td><a name="l555" href="#l555">555</a><td> * failure or a string.<tr><td><a name="l556" href="#l556">556</a><td> * @private<tr><td><a name="l557" href="#l557">557</a><td> */<tr><td><a name="l558" href="#l558">558</a><td>goog.testing.AsyncTestCase.prototype.doTopOfStackAsyncError_ =<tr><td><a name="l559" href="#l559">559</a><td> function(opt_e) {<tr><td><a name="l560" href="#l560">560</a><td> /** @preserveTry */<tr><td><a name="l561" href="#l561">561</a><td> try {<tr><td><a name="l562" href="#l562">562</a><td> this.doAsyncError(opt_e);<tr><td><a name="l563" href="#l563">563</a><td> } catch (e) {<tr><td><a name="l564" href="#l564">564</a><td> // We know that we are on the top of the stack, so there is no need to<tr><td><a name="l565" href="#l565">565</a><td> // throw this exception in this case.<tr><td><a name="l566" href="#l566">566</a><td> if (e.isControlBreakingException) {<tr><td><a name="l567" href="#l567">567</a><td> this.numControlExceptionsExpected_ -= 1;<tr><td><a name="l568" href="#l568">568</a><td> this.dbgLog_(&#39;doTopOfStackAsyncError_: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l569" href="#l569">569</a><td> this.numControlExceptionsExpected_ + &#39; and catching exception.&#39;);<tr><td><a name="l570" href="#l570">570</a><td> } else {<tr><td><a name="l571" href="#l571">571</a><td> throw e;<tr><td><a name="l572" href="#l572">572</a><td> }<tr><td><a name="l573" href="#l573">573</a><td> }<tr><td><a name="l574" href="#l574">574</a><td>};<tr><td><a name="l575" href="#l575">575</a><td><tr><td><a name="l576" href="#l576">576</a><td><tr><td><a name="l577" href="#l577">577</a><td>/**<tr><td><a name="l578" href="#l578">578</a><td> * Calls the tearDown function, catching any errors, and then moves on to<tr><td><a name="l579" href="#l579">579</a><td> * the next step in the testing cycle.<tr><td><a name="l580" href="#l580">580</a><td> * @private<tr><td><a name="l581" href="#l581">581</a><td> */<tr><td><a name="l582" href="#l582">582</a><td>goog.testing.AsyncTestCase.prototype.doAsyncErrorTearDown_ = function() {<tr><td><a name="l583" href="#l583">583</a><td> if (this.inException_) {<tr><td><a name="l584" href="#l584">584</a><td> // We get here if tearDown is throwing the error.<tr><td><a name="l585" href="#l585">585</a><td> // Upon calling continueTesting, the inline function &#39;doAsyncError&#39; (set<tr><td><a name="l586" href="#l586">586</a><td> // below) is run.<tr><td><a name="l587" href="#l587">587</a><td> this.endCurrentStep_();<tr><td><a name="l588" href="#l588">588</a><td> } else {<tr><td><a name="l589" href="#l589">589</a><td> this.inException_ = true;<tr><td><a name="l590" href="#l590">590</a><td> this.isReady_ = true;<tr><td><a name="l591" href="#l591">591</a><td><tr><td><a name="l592" href="#l592">592</a><td> // The continue point is different depending on if the error happened in<tr><td><a name="l593" href="#l593">593</a><td> // setUpPage() or in setUp()/test*()/tearDown().<tr><td><a name="l594" href="#l594">594</a><td> var stepFuncAfterError = this.nextStepFunc_;<tr><td><a name="l595" href="#l595">595</a><td> var stepNameAfterError = &#39;TestCase.execute (after error)&#39;;<tr><td><a name="l596" href="#l596">596</a><td> if (this.activeTest) {<tr><td><a name="l597" href="#l597">597</a><td> stepFuncAfterError = this.doIteration_;<tr><td><a name="l598" href="#l598">598</a><td> stepNameAfterError = &#39;doIteration (after error)&#39;;<tr><td><a name="l599" href="#l599">599</a><td> }<tr><td><a name="l600" href="#l600">600</a><td><tr><td><a name="l601" href="#l601">601</a><td> // We must set the next step before calling tearDown.<tr><td><a name="l602" href="#l602">602</a><td> this.setNextStep_(function() {<tr><td><a name="l603" href="#l603">603</a><td> this.inException_ = false;<tr><td><a name="l604" href="#l604">604</a><td> // This is null when an error happens in setUpPage.<tr><td><a name="l605" href="#l605">605</a><td> this.setNextStep_(stepFuncAfterError, stepNameAfterError);<tr><td><a name="l606" href="#l606">606</a><td> }, &#39;doAsyncError&#39;);<tr><td><a name="l607" href="#l607">607</a><td><tr><td><a name="l608" href="#l608">608</a><td> // Call the test&#39;s tearDown().<tr><td><a name="l609" href="#l609">609</a><td> if (!this.cleanedUp_) {<tr><td><a name="l610" href="#l610">610</a><td> this.cleanedUp_ = true;<tr><td><a name="l611" href="#l611">611</a><td> this.tearDown();<tr><td><a name="l612" href="#l612">612</a><td> }<tr><td><a name="l613" href="#l613">613</a><td> }<tr><td><a name="l614" href="#l614">614</a><td>};<tr><td><a name="l615" href="#l615">615</a><td><tr><td><a name="l616" href="#l616">616</a><td><tr><td><a name="l617" href="#l617">617</a><td>/**<tr><td><a name="l618" href="#l618">618</a><td> * Replaces the asserts.js assert_() and fail() functions with a wrappers to<tr><td><a name="l619" href="#l619">619</a><td> * catch the exceptions.<tr><td><a name="l620" href="#l620">620</a><td> * @private<tr><td><a name="l621" href="#l621">621</a><td> */<tr><td><a name="l622" href="#l622">622</a><td>goog.testing.AsyncTestCase.prototype.hookAssert_ = function() {<tr><td><a name="l623" href="#l623">623</a><td> if (!this.origAssert_) {<tr><td><a name="l624" href="#l624">624</a><td> this.origAssert_ = _assert;<tr><td><a name="l625" href="#l625">625</a><td> this.origFail_ = fail;<tr><td><a name="l626" href="#l626">626</a><td> var self = this;<tr><td><a name="l627" href="#l627">627</a><td> _assert = function() {<tr><td><a name="l628" href="#l628">628</a><td> /** @preserveTry */<tr><td><a name="l629" href="#l629">629</a><td> try {<tr><td><a name="l630" href="#l630">630</a><td> self.origAssert_.apply(this, arguments);<tr><td><a name="l631" href="#l631">631</a><td> } catch (e) {<tr><td><a name="l632" href="#l632">632</a><td> self.dbgLog_(&#39;Wrapping failed assert()&#39;);<tr><td><a name="l633" href="#l633">633</a><td> self.doAsyncError(e);<tr><td><a name="l634" href="#l634">634</a><td> }<tr><td><a name="l635" href="#l635">635</a><td> };<tr><td><a name="l636" href="#l636">636</a><td> fail = function() {<tr><td><a name="l637" href="#l637">637</a><td> /** @preserveTry */<tr><td><a name="l638" href="#l638">638</a><td> try {<tr><td><a name="l639" href="#l639">639</a><td> self.origFail_.apply(this, arguments);<tr><td><a name="l640" href="#l640">640</a><td> } catch (e) {<tr><td><a name="l641" href="#l641">641</a><td> self.dbgLog_(&#39;Wrapping fail()&#39;);<tr><td><a name="l642" href="#l642">642</a><td> self.doAsyncError(e);<tr><td><a name="l643" href="#l643">643</a><td> }<tr><td><a name="l644" href="#l644">644</a><td> };<tr><td><a name="l645" href="#l645">645</a><td> }<tr><td><a name="l646" href="#l646">646</a><td>};<tr><td><a name="l647" href="#l647">647</a><td><tr><td><a name="l648" href="#l648">648</a><td><tr><td><a name="l649" href="#l649">649</a><td>/**<tr><td><a name="l650" href="#l650">650</a><td> * Sets a window.onerror handler for catching exceptions that happen in async<tr><td><a name="l651" href="#l651">651</a><td> * callbacks. Note that as of Safari 3.1, Safari does not support this.<tr><td><a name="l652" href="#l652">652</a><td> * @private<tr><td><a name="l653" href="#l653">653</a><td> */<tr><td><a name="l654" href="#l654">654</a><td>goog.testing.AsyncTestCase.prototype.hookOnError_ = function() {<tr><td><a name="l655" href="#l655">655</a><td> if (!this.origOnError_) {<tr><td><a name="l656" href="#l656">656</a><td> this.origOnError_ = window.onerror;<tr><td><a name="l657" href="#l657">657</a><td> var self = this;<tr><td><a name="l658" href="#l658">658</a><td> window.onerror = function(error, url, line) {<tr><td><a name="l659" href="#l659">659</a><td> // Ignore exceptions that we threw on purpose.<tr><td><a name="l660" href="#l660">660</a><td> var cbe =<tr><td><a name="l661" href="#l661">661</a><td> goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l662" href="#l662">662</a><td> if (String(error).indexOf(cbe) != -1 &amp;&amp;<tr><td><a name="l663" href="#l663">663</a><td> self.numControlExceptionsExpected_) {<tr><td><a name="l664" href="#l664">664</a><td> self.numControlExceptionsExpected_ -= 1;<tr><td><a name="l665" href="#l665">665</a><td> self.dbgLog_(&#39;window.onerror: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l666" href="#l666">666</a><td> self.numControlExceptionsExpected_ + &#39; and ignoring exception. &#39; +<tr><td><a name="l667" href="#l667">667</a><td> error);<tr><td><a name="l668" href="#l668">668</a><td> // Tell the browser not to compain about the error.<tr><td><a name="l669" href="#l669">669</a><td> return true;<tr><td><a name="l670" href="#l670">670</a><td> } else {<tr><td><a name="l671" href="#l671">671</a><td> self.dbgLog_(&#39;window.onerror caught exception.&#39;);<tr><td><a name="l672" href="#l672">672</a><td> var message = error + &#39;\nURL: &#39; + url + &#39;\nLine: &#39; + line;<tr><td><a name="l673" href="#l673">673</a><td> self.doTopOfStackAsyncError_(message);<tr><td><a name="l674" href="#l674">674</a><td> // Tell the browser to complain about the error.<tr><td><a name="l675" href="#l675">675</a><td> return false;<tr><td><a name="l676" href="#l676">676</a><td> }<tr><td><a name="l677" href="#l677">677</a><td> };<tr><td><a name="l678" href="#l678">678</a><td> }<tr><td><a name="l679" href="#l679">679</a><td>};<tr><td><a name="l680" href="#l680">680</a><td><tr><td><a name="l681" href="#l681">681</a><td><tr><td><a name="l682" href="#l682">682</a><td>/**<tr><td><a name="l683" href="#l683">683</a><td> * Unhooks window.onerror and _assert.<tr><td><a name="l684" href="#l684">684</a><td> * @private<tr><td><a name="l685" href="#l685">685</a><td> */<tr><td><a name="l686" href="#l686">686</a><td>goog.testing.AsyncTestCase.prototype.unhookAll_ = function() {<tr><td><a name="l687" href="#l687">687</a><td> if (this.origOnError_) {<tr><td><a name="l688" href="#l688">688</a><td> window.onerror = this.origOnError_;<tr><td><a name="l689" href="#l689">689</a><td> this.origOnError_ = null;<tr><td><a name="l690" href="#l690">690</a><td> _assert = this.origAssert_;<tr><td><a name="l691" href="#l691">691</a><td> this.origAssert_ = null;<tr><td><a name="l692" href="#l692">692</a><td> fail = this.origFail_;<tr><td><a name="l693" href="#l693">693</a><td> this.origFail_ = null;<tr><td><a name="l694" href="#l694">694</a><td> }<tr><td><a name="l695" href="#l695">695</a><td>};<tr><td><a name="l696" href="#l696">696</a><td><tr><td><a name="l697" href="#l697">697</a><td><tr><td><a name="l698" href="#l698">698</a><td>/**<tr><td><a name="l699" href="#l699">699</a><td> * Enables the timeout timer. This timer fires unless continueTesting is<tr><td><a name="l700" href="#l700">700</a><td> * called.<tr><td><a name="l701" href="#l701">701</a><td> * @private<tr><td><a name="l702" href="#l702">702</a><td> */<tr><td><a name="l703" href="#l703">703</a><td>goog.testing.AsyncTestCase.prototype.startTimeoutTimer_ = function() {<tr><td><a name="l704" href="#l704">704</a><td> if (!this.timeoutHandle_ &amp;&amp; this.stepTimeout &gt; 0) {<tr><td><a name="l705" href="#l705">705</a><td> this.timeoutHandle_ = this.timeout(goog.bind(function() {<tr><td><a name="l706" href="#l706">706</a><td> this.dbgLog_(&#39;Timeout timer fired with id &#39; + this.timeoutHandle_);<tr><td><a name="l707" href="#l707">707</a><td> this.timeoutHandle_ = 0;<tr><td><a name="l708" href="#l708">708</a><td><tr><td><a name="l709" href="#l709">709</a><td> this.doTopOfStackAsyncError_(&#39;Timed out while waiting for &#39; +<tr><td><a name="l710" href="#l710">710</a><td> &#39;continueTesting() to be called.&#39;);<tr><td><a name="l711" href="#l711">711</a><td> }, this, null), this.stepTimeout);<tr><td><a name="l712" href="#l712">712</a><td> this.dbgLog_(&#39;Started timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l713" href="#l713">713</a><td> }<tr><td><a name="l714" href="#l714">714</a><td>};<tr><td><a name="l715" href="#l715">715</a><td><tr><td><a name="l716" href="#l716">716</a><td><tr><td><a name="l717" href="#l717">717</a><td>/**<tr><td><a name="l718" href="#l718">718</a><td> * Disables the timeout timer.<tr><td><a name="l719" href="#l719">719</a><td> * @private<tr><td><a name="l720" href="#l720">720</a><td> */<tr><td><a name="l721" href="#l721">721</a><td>goog.testing.AsyncTestCase.prototype.stopTimeoutTimer_ = function() {<tr><td><a name="l722" href="#l722">722</a><td> if (this.timeoutHandle_) {<tr><td><a name="l723" href="#l723">723</a><td> this.dbgLog_(&#39;Clearing timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l724" href="#l724">724</a><td> this.clearTimeout(this.timeoutHandle_);<tr><td><a name="l725" href="#l725">725</a><td> this.timeoutHandle_ = 0;<tr><td><a name="l726" href="#l726">726</a><td> }<tr><td><a name="l727" href="#l727">727</a><td>};<tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td><tr><td><a name="l730" href="#l730">730</a><td>/**<tr><td><a name="l731" href="#l731">731</a><td> * Sets the next function to call in our sequence of async callbacks.<tr><td><a name="l732" href="#l732">732</a><td> * @param {Function} func The function that executes the next step.<tr><td><a name="l733" href="#l733">733</a><td> * @param {string} name A description of the next step.<tr><td><a name="l734" href="#l734">734</a><td> * @private<tr><td><a name="l735" href="#l735">735</a><td> */<tr><td><a name="l736" href="#l736">736</a><td>goog.testing.AsyncTestCase.prototype.setNextStep_ = function(func, name) {<tr><td><a name="l737" href="#l737">737</a><td> this.nextStepFunc_ = func &amp;&amp; goog.bind(func, this);<tr><td><a name="l738" href="#l738">738</a><td> this.nextStepName_ = name;<tr><td><a name="l739" href="#l739">739</a><td>};<tr><td><a name="l740" href="#l740">740</a><td><tr><td><a name="l741" href="#l741">741</a><td><tr><td><a name="l742" href="#l742">742</a><td>/**<tr><td><a name="l743" href="#l743">743</a><td> * Calls the given function, redirecting any exceptions to doAsyncError.<tr><td><a name="l744" href="#l744">744</a><td> * @param {Function} func The function to call.<tr><td><a name="l745" href="#l745">745</a><td> * @return {!goog.testing.AsyncTestCase.TopStackFuncResult_} Returns a<tr><td><a name="l746" href="#l746">746</a><td> * TopStackFuncResult_.<tr><td><a name="l747" href="#l747">747</a><td> * @private<tr><td><a name="l748" href="#l748">748</a><td> */<tr><td><a name="l749" href="#l749">749</a><td>goog.testing.AsyncTestCase.prototype.callTopOfStackFunc_ = function(func) {<tr><td><a name="l750" href="#l750">750</a><td> /** @preserveTry */<tr><td><a name="l751" href="#l751">751</a><td> try {<tr><td><a name="l752" href="#l752">752</a><td> func.call(this);<tr><td><a name="l753" href="#l753">753</a><td> return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l754" href="#l754">754</a><td> } catch (e) {<tr><td><a name="l755" href="#l755">755</a><td> this.dbgLog_(&#39;Caught exception in callTopOfStackFunc_&#39;);<tr><td><a name="l756" href="#l756">756</a><td> /** @preserveTry */<tr><td><a name="l757" href="#l757">757</a><td> try {<tr><td><a name="l758" href="#l758">758</a><td> this.doAsyncError(e);<tr><td><a name="l759" href="#l759">759</a><td> return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l760" href="#l760">760</a><td> } catch (e2) {<tr><td><a name="l761" href="#l761">761</a><td> if (!e2.isControlBreakingException) {<tr><td><a name="l762" href="#l762">762</a><td> throw e2;<tr><td><a name="l763" href="#l763">763</a><td> }<tr><td><a name="l764" href="#l764">764</a><td> return {controlBreakingExceptionThrown: true, message: e2.message};<tr><td><a name="l765" href="#l765">765</a><td> }<tr><td><a name="l766" href="#l766">766</a><td> }<tr><td><a name="l767" href="#l767">767</a><td>};<tr><td><a name="l768" href="#l768">768</a><td><tr><td><a name="l769" href="#l769">769</a><td><tr><td><a name="l770" href="#l770">770</a><td>/**<tr><td><a name="l771" href="#l771">771</a><td> * Calls the next callback when the isReady_ flag is true.<tr><td><a name="l772" href="#l772">772</a><td> * @param {Function=} opt_doFirst A function to call before pumping.<tr><td><a name="l773" href="#l773">773</a><td> * @private<tr><td><a name="l774" href="#l774">774</a><td> * @throws Throws a ControlBreakingException if there were any failing steps.<tr><td><a name="l775" href="#l775">775</a><td> */<tr><td><a name="l776" href="#l776">776</a><td>goog.testing.AsyncTestCase.prototype.pump_ = function(opt_doFirst) {<tr><td><a name="l777" href="#l777">777</a><td> // If this function is already above us in the call-stack, then we should<tr><td><a name="l778" href="#l778">778</a><td> // return rather than pumping in order to minimize call-stack depth.<tr><td><a name="l779" href="#l779">779</a><td> if (!this.returnWillPump_) {<tr><td><a name="l780" href="#l780">780</a><td> this.setBatchTime(this.now());<tr><td><a name="l781" href="#l781">781</a><td> this.returnWillPump_ = true;<tr><td><a name="l782" href="#l782">782</a><td> var topFuncResult = {};<tr><td><a name="l783" href="#l783">783</a><td><tr><td><a name="l784" href="#l784">784</a><td> if (opt_doFirst) {<tr><td><a name="l785" href="#l785">785</a><td> topFuncResult = this.callTopOfStackFunc_(opt_doFirst);<tr><td><a name="l786" href="#l786">786</a><td> }<tr><td><a name="l787" href="#l787">787</a><td> // Note: we don&#39;t check for this.running here because it is not set to true<tr><td><a name="l788" href="#l788">788</a><td> // while executing setUpPage and tearDownPage.<tr><td><a name="l789" href="#l789">789</a><td> // Also, if isReady_ is false, then one of two things will happen:<tr><td><a name="l790" href="#l790">790</a><td> // 1. Our timeout callback will be called.<tr><td><a name="l791" href="#l791">791</a><td> // 2. The tests will call continueTesting(), which will call pump_() again.<tr><td><a name="l792" href="#l792">792</a><td> while (this.isReady_ &amp;&amp; this.nextStepFunc_ &amp;&amp;<tr><td><a name="l793" href="#l793">793</a><td> !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l794" href="#l794">794</a><td> this.curStepFunc_ = this.nextStepFunc_;<tr><td><a name="l795" href="#l795">795</a><td> this.curStepName_ = this.nextStepName_;<tr><td><a name="l796" href="#l796">796</a><td> this.nextStepFunc_ = null;<tr><td><a name="l797" href="#l797">797</a><td> this.nextStepName_ = &#39;&#39;;<tr><td><a name="l798" href="#l798">798</a><td><tr><td><a name="l799" href="#l799">799</a><td> this.dbgLog_(&#39;Performing step: &#39; + this.curStepName_);<tr><td><a name="l800" href="#l800">800</a><td> topFuncResult =<tr><td><a name="l801" href="#l801">801</a><td> this.callTopOfStackFunc_(/** @type {Function} */(this.curStepFunc_));<tr><td><a name="l802" href="#l802">802</a><td><tr><td><a name="l803" href="#l803">803</a><td> // If the max run time is exceeded call this function again async so as<tr><td><a name="l804" href="#l804">804</a><td> // not to block the browser.<tr><td><a name="l805" href="#l805">805</a><td> var delta = this.now() - this.getBatchTime();<tr><td><a name="l806" href="#l806">806</a><td> if (delta &gt; goog.testing.TestCase.maxRunTime &amp;&amp;<tr><td><a name="l807" href="#l807">807</a><td> !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l808" href="#l808">808</a><td> this.saveMessage(&#39;Breaking async&#39;);<tr><td><a name="l809" href="#l809">809</a><td> var self = this;<tr><td><a name="l810" href="#l810">810</a><td> this.timeout(function() { self.pump_(); }, 100);<tr><td><a name="l811" href="#l811">811</a><td> break;<tr><td><a name="l812" href="#l812">812</a><td> }<tr><td><a name="l813" href="#l813">813</a><td> }<tr><td><a name="l814" href="#l814">814</a><td> this.returnWillPump_ = false;<tr><td><a name="l815" href="#l815">815</a><td> } else if (opt_doFirst) {<tr><td><a name="l816" href="#l816">816</a><td> opt_doFirst.call(this);<tr><td><a name="l817" href="#l817">817</a><td> }<tr><td><a name="l818" href="#l818">818</a><td>};<tr><td><a name="l819" href="#l819">819</a><td><tr><td><a name="l820" href="#l820">820</a><td><tr><td><a name="l821" href="#l821">821</a><td>/**<tr><td><a name="l822" href="#l822">822</a><td> * Sets up the test page and then waits untill the test case has been marked<tr><td><a name="l823" href="#l823">823</a><td> * as ready before executing the tests.<tr><td><a name="l824" href="#l824">824</a><td> * @private<tr><td><a name="l825" href="#l825">825</a><td> */<tr><td><a name="l826" href="#l826">826</a><td>goog.testing.AsyncTestCase.prototype.doSetUpPage_ = function() {<tr><td><a name="l827" href="#l827">827</a><td> this.setNextStep_(this.execute, &#39;TestCase.execute&#39;);<tr><td><a name="l828" href="#l828">828</a><td> this.setUpPage();<tr><td><a name="l829" href="#l829">829</a><td>};<tr><td><a name="l830" href="#l830">830</a><td><tr><td><a name="l831" href="#l831">831</a><td><tr><td><a name="l832" href="#l832">832</a><td>/**<tr><td><a name="l833" href="#l833">833</a><td> * Step 1: Move to the next test.<tr><td><a name="l834" href="#l834">834</a><td> * @private<tr><td><a name="l835" href="#l835">835</a><td> */<tr><td><a name="l836" href="#l836">836</a><td>goog.testing.AsyncTestCase.prototype.doIteration_ = function() {<tr><td><a name="l837" href="#l837">837</a><td> this.expectedSignalCount_ = 0;<tr><td><a name="l838" href="#l838">838</a><td> this.receivedSignalCount_ = 0;<tr><td><a name="l839" href="#l839">839</a><td> this.activeTest = this.next();<tr><td><a name="l840" href="#l840">840</a><td> if (this.activeTest &amp;&amp; this.running) {<tr><td><a name="l841" href="#l841">841</a><td> this.result_.runCount++;<tr><td><a name="l842" href="#l842">842</a><td> // If this test should be marked as having failed, doIteration will go<tr><td><a name="l843" href="#l843">843</a><td> // straight to the next test.<tr><td><a name="l844" href="#l844">844</a><td> if (this.maybeFailTestEarly(this.activeTest)) {<tr><td><a name="l845" href="#l845">845</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l846" href="#l846">846</a><td> } else {<tr><td><a name="l847" href="#l847">847</a><td> this.setNextStep_(this.doSetUp_, &#39;setUp&#39;);<tr><td><a name="l848" href="#l848">848</a><td> }<tr><td><a name="l849" href="#l849">849</a><td> } else {<tr><td><a name="l850" href="#l850">850</a><td> // All tests done.<tr><td><a name="l851" href="#l851">851</a><td> this.finalize();<tr><td><a name="l852" href="#l852">852</a><td> }<tr><td><a name="l853" href="#l853">853</a><td>};<tr><td><a name="l854" href="#l854">854</a><td><tr><td><a name="l855" href="#l855">855</a><td><tr><td><a name="l856" href="#l856">856</a><td>/**<tr><td><a name="l857" href="#l857">857</a><td> * Step 2: Call setUp().<tr><td><a name="l858" href="#l858">858</a><td> * @private<tr><td><a name="l859" href="#l859">859</a><td> */<tr><td><a name="l860" href="#l860">860</a><td>goog.testing.AsyncTestCase.prototype.doSetUp_ = function() {<tr><td><a name="l861" href="#l861">861</a><td> this.log(&#39;Running test: &#39; + this.activeTest.name);<tr><td><a name="l862" href="#l862">862</a><td> this.cleanedUp_ = false;<tr><td><a name="l863" href="#l863">863</a><td> this.setNextStep_(this.doExecute_, this.activeTest.name);<tr><td><a name="l864" href="#l864">864</a><td> this.setUp();<tr><td><a name="l865" href="#l865">865</a><td>};<tr><td><a name="l866" href="#l866">866</a><td><tr><td><a name="l867" href="#l867">867</a><td><tr><td><a name="l868" href="#l868">868</a><td>/**<tr><td><a name="l869" href="#l869">869</a><td> * Step 3: Call test.execute().<tr><td><a name="l870" href="#l870">870</a><td> * @private<tr><td><a name="l871" href="#l871">871</a><td> */<tr><td><a name="l872" href="#l872">872</a><td>goog.testing.AsyncTestCase.prototype.doExecute_ = function() {<tr><td><a name="l873" href="#l873">873</a><td> this.setNextStep_(this.doTearDown_, &#39;tearDown&#39;);<tr><td><a name="l874" href="#l874">874</a><td> this.activeTest.execute();<tr><td><a name="l875" href="#l875">875</a><td>};<tr><td><a name="l876" href="#l876">876</a><td><tr><td><a name="l877" href="#l877">877</a><td><tr><td><a name="l878" href="#l878">878</a><td>/**<tr><td><a name="l879" href="#l879">879</a><td> * Step 4: Call tearDown().<tr><td><a name="l880" href="#l880">880</a><td> * @private<tr><td><a name="l881" href="#l881">881</a><td> */<tr><td><a name="l882" href="#l882">882</a><td>goog.testing.AsyncTestCase.prototype.doTearDown_ = function() {<tr><td><a name="l883" href="#l883">883</a><td> this.cleanedUp_ = true;<tr><td><a name="l884" href="#l884">884</a><td> this.setNextStep_(this.doNext_, &#39;doNext&#39;);<tr><td><a name="l885" href="#l885">885</a><td> this.tearDown();<tr><td><a name="l886" href="#l886">886</a><td>};<tr><td><a name="l887" href="#l887">887</a><td><tr><td><a name="l888" href="#l888">888</a><td><tr><td><a name="l889" href="#l889">889</a><td>/**<tr><td><a name="l890" href="#l890">890</a><td> * Step 5: Call doSuccess()<tr><td><a name="l891" href="#l891">891</a><td> * @private<tr><td><a name="l892" href="#l892">892</a><td> */<tr><td><a name="l893" href="#l893">893</a><td>goog.testing.AsyncTestCase.prototype.doNext_ = function() {<tr><td><a name="l894" href="#l894">894</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l895" href="#l895">895</a><td> this.doSuccess(/** @type {goog.testing.TestCase.Test} */(this.activeTest));<tr><td><a name="l896" href="#l896">896</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
1
+ <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>asynctestcase.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/testing/asynctestcase.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td>// All Rights Reserved.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview A class representing a set of test functions that use<tr><td><a name="l18" href="#l18">18</a><td> * asynchronous functions that cannot be meaningfully mocked.<tr><td><a name="l19" href="#l19">19</a><td> *<tr><td><a name="l20" href="#l20">20</a><td> * To create a Google-compatable JsUnit test using this test case, put the<tr><td><a name="l21" href="#l21">21</a><td> * following snippet in your test:<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l24" href="#l24">24</a><td> *<tr><td><a name="l25" href="#l25">25</a><td> * To make the test runner wait for your asynchronous behaviour, use:<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> * asyncTestCase.waitForAsync(&#39;Waiting for xhr to respond&#39;);<tr><td><a name="l28" href="#l28">28</a><td> *<tr><td><a name="l29" href="#l29">29</a><td> * The next test will not start until the following call is made, or a<tr><td><a name="l30" href="#l30">30</a><td> * timeout occurs:<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l33" href="#l33">33</a><td> *<tr><td><a name="l34" href="#l34">34</a><td> * There does NOT need to be a 1:1 mapping of waitForAsync calls and<tr><td><a name="l35" href="#l35">35</a><td> * continueTesting calls. The next test will be run after a single call to<tr><td><a name="l36" href="#l36">36</a><td> * continueTesting is made, as long as there is no subsequent call to<tr><td><a name="l37" href="#l37">37</a><td> * waitForAsync in the same thread.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * Example:<tr><td><a name="l40" href="#l40">40</a><td> * // Returning here would cause the next test to be run.<tr><td><a name="l41" href="#l41">41</a><td> * asyncTestCase.waitForAsync(&#39;description 1&#39;);<tr><td><a name="l42" href="#l42">42</a><td> * // Returning here would *not* cause the next test to be run.<tr><td><a name="l43" href="#l43">43</a><td> * // Only effect of additional waitForAsync() calls is an updated<tr><td><a name="l44" href="#l44">44</a><td> * // description in the case of a timeout.<tr><td><a name="l45" href="#l45">45</a><td> * asyncTestCase.waitForAsync(&#39;updated description&#39;);<tr><td><a name="l46" href="#l46">46</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l47" href="#l47">47</a><td> * // Returning here would cause the next test to be run.<tr><td><a name="l48" href="#l48">48</a><td> * asyncTestCase.waitForAsync(&#39;just kidding, still running.&#39;);<tr><td><a name="l49" href="#l49">49</a><td> * // Returning here would *not* cause the next test to be run.<tr><td><a name="l50" href="#l50">50</a><td> *<tr><td><a name="l51" href="#l51">51</a><td> * The test runner can also be made to wait for more than one asynchronous<tr><td><a name="l52" href="#l52">52</a><td> * event with:<tr><td><a name="l53" href="#l53">53</a><td> *<tr><td><a name="l54" href="#l54">54</a><td> * asyncTestCase.waitForSignals(n);<tr><td><a name="l55" href="#l55">55</a><td> *<tr><td><a name="l56" href="#l56">56</a><td> * The next test will not start until asyncTestCase.signal() is called n times,<tr><td><a name="l57" href="#l57">57</a><td> * or the test step timeout is exceeded.<tr><td><a name="l58" href="#l58">58</a><td> *<tr><td><a name="l59" href="#l59">59</a><td> * This class supports asynchronous behaviour in all test functions except for<tr><td><a name="l60" href="#l60">60</a><td> * tearDownPage. If such support is needed, it can be added.<tr><td><a name="l61" href="#l61">61</a><td> *<tr><td><a name="l62" href="#l62">62</a><td> * Example Usage:<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l65" href="#l65">65</a><td> * // Optionally, set a longer-than-normal step timeout.<tr><td><a name="l66" href="#l66">66</a><td> * asyncTestCase.stepTimeout = 30 * 1000;<tr><td><a name="l67" href="#l67">67</a><td> *<tr><td><a name="l68" href="#l68">68</a><td> * function testSetTimeout() {<tr><td><a name="l69" href="#l69">69</a><td> * var step = 0;<tr><td><a name="l70" href="#l70">70</a><td> * function stepCallback() {<tr><td><a name="l71" href="#l71">71</a><td> * step++;<tr><td><a name="l72" href="#l72">72</a><td> * switch (step) {<tr><td><a name="l73" href="#l73">73</a><td> * case 1:<tr><td><a name="l74" href="#l74">74</a><td> * var startTime = goog.now();<tr><td><a name="l75" href="#l75">75</a><td> * asyncTestCase.waitForAsync(&#39;step 1&#39;);<tr><td><a name="l76" href="#l76">76</a><td> * window.setTimeout(stepCallback, 100);<tr><td><a name="l77" href="#l77">77</a><td> * break;<tr><td><a name="l78" href="#l78">78</a><td> * case 2:<tr><td><a name="l79" href="#l79">79</a><td> * assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l80" href="#l80">80</a><td> * goog.now() - startTime &gt;= 100);<tr><td><a name="l81" href="#l81">81</a><td> * asyncTestCase.waitForAsync(&#39;step 2&#39;);<tr><td><a name="l82" href="#l82">82</a><td> * window.setTimeout(stepCallback, 100);<tr><td><a name="l83" href="#l83">83</a><td> * break;<tr><td><a name="l84" href="#l84">84</a><td> * case 3:<tr><td><a name="l85" href="#l85">85</a><td> * assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l86" href="#l86">86</a><td> * goog.now() - startTime &gt;= 200);<tr><td><a name="l87" href="#l87">87</a><td> * asyncTestCase.continueTesting();<tr><td><a name="l88" href="#l88">88</a><td> * break;<tr><td><a name="l89" href="#l89">89</a><td> * default:<tr><td><a name="l90" href="#l90">90</a><td> * fail(&#39;Unexpected call to stepCallback&#39;);<tr><td><a name="l91" href="#l91">91</a><td> * }<tr><td><a name="l92" href="#l92">92</a><td> * }<tr><td><a name="l93" href="#l93">93</a><td> * stepCallback();<tr><td><a name="l94" href="#l94">94</a><td> * }<tr><td><a name="l95" href="#l95">95</a><td> *<tr><td><a name="l96" href="#l96">96</a><td> * Known Issues:<tr><td><a name="l97" href="#l97">97</a><td> * IE7 Exceptions:<tr><td><a name="l98" href="#l98">98</a><td> * As the failingtest.html will show, it appears as though ie7 does not<tr><td><a name="l99" href="#l99">99</a><td> * propagate an exception past a function called using the func.call()<tr><td><a name="l100" href="#l100">100</a><td> * syntax. This causes case 3 of the failing tests (exceptions) to show up<tr><td><a name="l101" href="#l101">101</a><td> * as timeouts in IE.<tr><td><a name="l102" href="#l102">102</a><td> * window.onerror:<tr><td><a name="l103" href="#l103">103</a><td> * This seems to catch errors only in ff2/ff3. It does not work in Safari or<tr><td><a name="l104" href="#l104">104</a><td> * IE7. The consequence of this is that exceptions that would have been<tr><td><a name="l105" href="#l105">105</a><td> * caught by window.onerror show up as timeouts.<tr><td><a name="l106" href="#l106">106</a><td> *<tr><td><a name="l107" href="#l107">107</a><td> * @author agrieve@google.com (Andrew Grieve)<tr><td><a name="l108" href="#l108">108</a><td> */<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>goog.provide(&#39;goog.testing.AsyncTestCase&#39;);<tr><td><a name="l111" href="#l111">111</a><td>goog.provide(&#39;goog.testing.AsyncTestCase.ControlBreakingException&#39;);<tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<tr><td><a name="l114" href="#l114">114</a><td>goog.require(&#39;goog.testing.TestCase.Test&#39;);<tr><td><a name="l115" href="#l115">115</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/**<tr><td><a name="l120" href="#l120">120</a><td> * A test case that is capable of running tests the contain asynchronous logic.<tr><td><a name="l121" href="#l121">121</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l122" href="#l122">122</a><td> * @extends {goog.testing.TestCase}<tr><td><a name="l123" href="#l123">123</a><td> * @constructor<tr><td><a name="l124" href="#l124">124</a><td> */<tr><td><a name="l125" href="#l125">125</a><td>goog.testing.AsyncTestCase = function(opt_name) {<tr><td><a name="l126" href="#l126">126</a><td> goog.testing.TestCase.call(this, opt_name);<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td>goog.inherits(goog.testing.AsyncTestCase, goog.testing.TestCase);<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * Represents result of top stack function call.<tr><td><a name="l133" href="#l133">133</a><td> * @typedef {{controlBreakingExceptionThrown: boolean, message: string}}<tr><td><a name="l134" href="#l134">134</a><td> * @private<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.testing.AsyncTestCase.TopStackFuncResult_;<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>/**<tr><td><a name="l141" href="#l141">141</a><td> * An exception class used solely for control flow.<tr><td><a name="l142" href="#l142">142</a><td> * @param {string=} opt_message Error message.<tr><td><a name="l143" href="#l143">143</a><td> * @constructor<tr><td><a name="l144" href="#l144">144</a><td> * @final<tr><td><a name="l145" href="#l145">145</a><td> */<tr><td><a name="l146" href="#l146">146</a><td>goog.testing.AsyncTestCase.ControlBreakingException = function(opt_message) {<tr><td><a name="l147" href="#l147">147</a><td> /**<tr><td><a name="l148" href="#l148">148</a><td> * The exception message.<tr><td><a name="l149" href="#l149">149</a><td> * @type {string}<tr><td><a name="l150" href="#l150">150</a><td> */<tr><td><a name="l151" href="#l151">151</a><td> this.message = opt_message || &#39;&#39;;<tr><td><a name="l152" href="#l152">152</a><td>};<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * Return value for .toString().<tr><td><a name="l157" href="#l157">157</a><td> * @type {string}<tr><td><a name="l158" href="#l158">158</a><td> */<tr><td><a name="l159" href="#l159">159</a><td>goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING =<tr><td><a name="l160" href="#l160">160</a><td> &#39;[AsyncTestCase.ControlBreakingException]&#39;;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td>/**<tr><td><a name="l164" href="#l164">164</a><td> * Marks this object as a ControlBreakingException<tr><td><a name="l165" href="#l165">165</a><td> * @type {boolean}<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.<tr><td><a name="l168" href="#l168">168</a><td> isControlBreakingException = true;<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/** @override */<tr><td><a name="l172" href="#l172">172</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.toString =<tr><td><a name="l173" href="#l173">173</a><td> function() {<tr><td><a name="l174" href="#l174">174</a><td> // This shows up in the console when the exception is not caught.<tr><td><a name="l175" href="#l175">175</a><td> return goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l176" href="#l176">176</a><td>};<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * How long to wait for a single step of a test to complete in milliseconds.<tr><td><a name="l181" href="#l181">181</a><td> * A step starts when a call to waitForAsync() is made.<tr><td><a name="l182" href="#l182">182</a><td> * @type {number}<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>goog.testing.AsyncTestCase.prototype.stepTimeout = 1000;<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * How long to wait after a failed test before moving onto the next one.<tr><td><a name="l189" href="#l189">189</a><td> * The purpose of this is to allow any pending async callbacks from the failing<tr><td><a name="l190" href="#l190">190</a><td> * test to finish up and not cause the next test to fail.<tr><td><a name="l191" href="#l191">191</a><td> * @type {number}<tr><td><a name="l192" href="#l192">192</a><td> */<tr><td><a name="l193" href="#l193">193</a><td>goog.testing.AsyncTestCase.prototype.timeToSleepAfterFailure = 500;<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td><tr><td><a name="l196" href="#l196">196</a><td>/**<tr><td><a name="l197" href="#l197">197</a><td> * Turn on extra logging to help debug failing async. tests.<tr><td><a name="l198" href="#l198">198</a><td> * @type {boolean}<tr><td><a name="l199" href="#l199">199</a><td> * @private<tr><td><a name="l200" href="#l200">200</a><td> */<tr><td><a name="l201" href="#l201">201</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogs_ = false;<tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td>/**<tr><td><a name="l205" href="#l205">205</a><td> * A reference to the original asserts.js assert_() function.<tr><td><a name="l206" href="#l206">206</a><td> * @private<tr><td><a name="l207" href="#l207">207</a><td> */<tr><td><a name="l208" href="#l208">208</a><td>goog.testing.AsyncTestCase.prototype.origAssert_;<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td>/**<tr><td><a name="l212" href="#l212">212</a><td> * A reference to the original asserts.js fail() function.<tr><td><a name="l213" href="#l213">213</a><td> * @private<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.testing.AsyncTestCase.prototype.origFail_;<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * A reference to the original window.onerror function.<tr><td><a name="l220" href="#l220">220</a><td> * @type {Function|undefined}<tr><td><a name="l221" href="#l221">221</a><td> * @private<tr><td><a name="l222" href="#l222">222</a><td> */<tr><td><a name="l223" href="#l223">223</a><td>goog.testing.AsyncTestCase.prototype.origOnError_;<tr><td><a name="l224" href="#l224">224</a><td><tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>/**<tr><td><a name="l227" href="#l227">227</a><td> * The stage of the test we are currently on.<tr><td><a name="l228" href="#l228">228</a><td> * @type {Function|undefined}}<tr><td><a name="l229" href="#l229">229</a><td> * @private<tr><td><a name="l230" href="#l230">230</a><td> */<tr><td><a name="l231" href="#l231">231</a><td>goog.testing.AsyncTestCase.prototype.curStepFunc_;<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * The name of the stage of the test we are currently on.<tr><td><a name="l236" href="#l236">236</a><td> * @type {string}<tr><td><a name="l237" href="#l237">237</a><td> * @private<tr><td><a name="l238" href="#l238">238</a><td> */<tr><td><a name="l239" href="#l239">239</a><td>goog.testing.AsyncTestCase.prototype.curStepName_ = &#39;&#39;;<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>/**<tr><td><a name="l243" href="#l243">243</a><td> * The stage of the test we should run next.<tr><td><a name="l244" href="#l244">244</a><td> * @type {Function|undefined}<tr><td><a name="l245" href="#l245">245</a><td> * @private<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>goog.testing.AsyncTestCase.prototype.nextStepFunc;<tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>/**<tr><td><a name="l251" href="#l251">251</a><td> * The name of the stage of the test we should run next.<tr><td><a name="l252" href="#l252">252</a><td> * @type {string}<tr><td><a name="l253" href="#l253">253</a><td> * @private<tr><td><a name="l254" href="#l254">254</a><td> */<tr><td><a name="l255" href="#l255">255</a><td>goog.testing.AsyncTestCase.prototype.nextStepName_ = &#39;&#39;;<tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>/**<tr><td><a name="l259" href="#l259">259</a><td> * The handle to the current setTimeout timer.<tr><td><a name="l260" href="#l260">260</a><td> * @type {number}<tr><td><a name="l261" href="#l261">261</a><td> * @private<tr><td><a name="l262" href="#l262">262</a><td> */<tr><td><a name="l263" href="#l263">263</a><td>goog.testing.AsyncTestCase.prototype.timeoutHandle_ = 0;<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td>/**<tr><td><a name="l267" href="#l267">267</a><td> * Marks if the cleanUp() function has been called for the currently running<tr><td><a name="l268" href="#l268">268</a><td> * test.<tr><td><a name="l269" href="#l269">269</a><td> * @type {boolean}<tr><td><a name="l270" href="#l270">270</a><td> * @private<tr><td><a name="l271" href="#l271">271</a><td> */<tr><td><a name="l272" href="#l272">272</a><td>goog.testing.AsyncTestCase.prototype.cleanedUp_ = false;<tr><td><a name="l273" href="#l273">273</a><td><tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td>/**<tr><td><a name="l276" href="#l276">276</a><td> * The currently active test.<tr><td><a name="l277" href="#l277">277</a><td> * @type {goog.testing.TestCase.Test|undefined}<tr><td><a name="l278" href="#l278">278</a><td> * @protected<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td>goog.testing.AsyncTestCase.prototype.activeTest;<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * A flag to prevent recursive exception handling.<tr><td><a name="l285" href="#l285">285</a><td> * @type {boolean}<tr><td><a name="l286" href="#l286">286</a><td> * @private<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td>goog.testing.AsyncTestCase.prototype.inException_ = false;<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td>/**<tr><td><a name="l292" href="#l292">292</a><td> * Flag used to determine if we can move to the next step in the testing loop.<tr><td><a name="l293" href="#l293">293</a><td> * @type {boolean}<tr><td><a name="l294" href="#l294">294</a><td> * @private<tr><td><a name="l295" href="#l295">295</a><td> */<tr><td><a name="l296" href="#l296">296</a><td>goog.testing.AsyncTestCase.prototype.isReady_ = true;<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>/**<tr><td><a name="l300" href="#l300">300</a><td> * Number of signals to wait for before continuing testing when waitForSignals<tr><td><a name="l301" href="#l301">301</a><td> * is used.<tr><td><a name="l302" href="#l302">302</a><td> * @type {number}<tr><td><a name="l303" href="#l303">303</a><td> * @private<tr><td><a name="l304" href="#l304">304</a><td> */<tr><td><a name="l305" href="#l305">305</a><td>goog.testing.AsyncTestCase.prototype.expectedSignalCount_ = 0;<tr><td><a name="l306" href="#l306">306</a><td><tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td>/**<tr><td><a name="l309" href="#l309">309</a><td> * Number of signals received.<tr><td><a name="l310" href="#l310">310</a><td> * @type {number}<tr><td><a name="l311" href="#l311">311</a><td> * @private<tr><td><a name="l312" href="#l312">312</a><td> */<tr><td><a name="l313" href="#l313">313</a><td>goog.testing.AsyncTestCase.prototype.receivedSignalCount_ = 0;<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td>/**<tr><td><a name="l317" href="#l317">317</a><td> * Flag that tells us if there is a function in the call stack that will make<tr><td><a name="l318" href="#l318">318</a><td> * a call to pump_().<tr><td><a name="l319" href="#l319">319</a><td> * @type {boolean}<tr><td><a name="l320" href="#l320">320</a><td> * @private<tr><td><a name="l321" href="#l321">321</a><td> */<tr><td><a name="l322" href="#l322">322</a><td>goog.testing.AsyncTestCase.prototype.returnWillPump_ = false;<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td><tr><td><a name="l325" href="#l325">325</a><td>/**<tr><td><a name="l326" href="#l326">326</a><td> * The number of times we have thrown a ControlBreakingException so that we<tr><td><a name="l327" href="#l327">327</a><td> * know not to complain in our window.onerror handler. In Webkit, window.onerror<tr><td><a name="l328" href="#l328">328</a><td> * is not supported, and so this counter will keep going up but we won&#39;t care<tr><td><a name="l329" href="#l329">329</a><td> * about it.<tr><td><a name="l330" href="#l330">330</a><td> * @type {number}<tr><td><a name="l331" href="#l331">331</a><td> * @private<tr><td><a name="l332" href="#l332">332</a><td> */<tr><td><a name="l333" href="#l333">333</a><td>goog.testing.AsyncTestCase.prototype.numControlExceptionsExpected_ = 0;<tr><td><a name="l334" href="#l334">334</a><td><tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td>/**<tr><td><a name="l337" href="#l337">337</a><td> * The current step name.<tr><td><a name="l338" href="#l338">338</a><td> * @return {!string} Step name.<tr><td><a name="l339" href="#l339">339</a><td> * @protected<tr><td><a name="l340" href="#l340">340</a><td> */<tr><td><a name="l341" href="#l341">341</a><td>goog.testing.AsyncTestCase.prototype.getCurrentStepName = function() {<tr><td><a name="l342" href="#l342">342</a><td> return this.curStepName_;<tr><td><a name="l343" href="#l343">343</a><td>};<tr><td><a name="l344" href="#l344">344</a><td><tr><td><a name="l345" href="#l345">345</a><td><tr><td><a name="l346" href="#l346">346</a><td>/**<tr><td><a name="l347" href="#l347">347</a><td> * Preferred way of creating an AsyncTestCase. Creates one and initializes it<tr><td><a name="l348" href="#l348">348</a><td> * with the G_testRunner.<tr><td><a name="l349" href="#l349">349</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l350" href="#l350">350</a><td> * @return {!goog.testing.AsyncTestCase} The created AsyncTestCase.<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.testing.AsyncTestCase.createAndInstall = function(opt_name) {<tr><td><a name="l353" href="#l353">353</a><td> var asyncTestCase = new goog.testing.AsyncTestCase(opt_name);<tr><td><a name="l354" href="#l354">354</a><td> goog.testing.TestCase.initializeTestRunner(asyncTestCase);<tr><td><a name="l355" href="#l355">355</a><td> return asyncTestCase;<tr><td><a name="l356" href="#l356">356</a><td>};<tr><td><a name="l357" href="#l357">357</a><td><tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td>/**<tr><td><a name="l360" href="#l360">360</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l361" href="#l361">361</a><td> * until continueTesting is called.<tr><td><a name="l362" href="#l362">362</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l363" href="#l363">363</a><td> */<tr><td><a name="l364" href="#l364">364</a><td>goog.testing.AsyncTestCase.prototype.waitForAsync = function(opt_name) {<tr><td><a name="l365" href="#l365">365</a><td> this.isReady_ = false;<tr><td><a name="l366" href="#l366">366</a><td> this.curStepName_ = opt_name || this.curStepName_;<tr><td><a name="l367" href="#l367">367</a><td><tr><td><a name="l368" href="#l368">368</a><td> // Reset the timer that tracks if the async test takes too long.<tr><td><a name="l369" href="#l369">369</a><td> this.stopTimeoutTimer_();<tr><td><a name="l370" href="#l370">370</a><td> this.startTimeoutTimer_();<tr><td><a name="l371" href="#l371">371</a><td>};<tr><td><a name="l372" href="#l372">372</a><td><tr><td><a name="l373" href="#l373">373</a><td><tr><td><a name="l374" href="#l374">374</a><td>/**<tr><td><a name="l375" href="#l375">375</a><td> * Continue with the next step in the test cycle.<tr><td><a name="l376" href="#l376">376</a><td> */<tr><td><a name="l377" href="#l377">377</a><td>goog.testing.AsyncTestCase.prototype.continueTesting = function() {<tr><td><a name="l378" href="#l378">378</a><td> if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l379" href="#l379">379</a><td> var remaining = this.expectedSignalCount_ - this.receivedSignalCount_;<tr><td><a name="l380" href="#l380">380</a><td> throw Error(&#39;Still waiting for &#39; + remaining + &#39; signals.&#39;);<tr><td><a name="l381" href="#l381">381</a><td> }<tr><td><a name="l382" href="#l382">382</a><td> this.endCurrentStep_();<tr><td><a name="l383" href="#l383">383</a><td>};<tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>/**<tr><td><a name="l387" href="#l387">387</a><td> * Ends the current test step and queues the next test step to run.<tr><td><a name="l388" href="#l388">388</a><td> * @private<tr><td><a name="l389" href="#l389">389</a><td> */<tr><td><a name="l390" href="#l390">390</a><td>goog.testing.AsyncTestCase.prototype.endCurrentStep_ = function() {<tr><td><a name="l391" href="#l391">391</a><td> if (!this.isReady_) {<tr><td><a name="l392" href="#l392">392</a><td> // We are a potential entry point, so we pump.<tr><td><a name="l393" href="#l393">393</a><td> this.isReady_ = true;<tr><td><a name="l394" href="#l394">394</a><td> this.stopTimeoutTimer_();<tr><td><a name="l395" href="#l395">395</a><td> // Run this in a setTimeout so that the caller has a chance to call<tr><td><a name="l396" href="#l396">396</a><td> // waitForAsync() again before we continue.<tr><td><a name="l397" href="#l397">397</a><td> this.timeout(goog.bind(this.pump_, this, null), 0);<tr><td><a name="l398" href="#l398">398</a><td> }<tr><td><a name="l399" href="#l399">399</a><td>};<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td><tr><td><a name="l402" href="#l402">402</a><td>/**<tr><td><a name="l403" href="#l403">403</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l404" href="#l404">404</a><td> * until signal is called the specified number of times. Within a test, this<tr><td><a name="l405" href="#l405">405</a><td> * function behaves additively if called multiple times; the number of signals<tr><td><a name="l406" href="#l406">406</a><td> * to wait for will be the sum of all expected number of signals this function<tr><td><a name="l407" href="#l407">407</a><td> * was called with.<tr><td><a name="l408" href="#l408">408</a><td> * @param {number} times The number of signals to receive before<tr><td><a name="l409" href="#l409">409</a><td> * continuing testing.<tr><td><a name="l410" href="#l410">410</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l411" href="#l411">411</a><td> */<tr><td><a name="l412" href="#l412">412</a><td>goog.testing.AsyncTestCase.prototype.waitForSignals =<tr><td><a name="l413" href="#l413">413</a><td> function(times, opt_name) {<tr><td><a name="l414" href="#l414">414</a><td> this.expectedSignalCount_ += times;<tr><td><a name="l415" href="#l415">415</a><td> if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l416" href="#l416">416</a><td> this.waitForAsync(opt_name);<tr><td><a name="l417" href="#l417">417</a><td> }<tr><td><a name="l418" href="#l418">418</a><td>};<tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td>/**<tr><td><a name="l422" href="#l422">422</a><td> * Signals once to continue with the test. If this is the last signal that the<tr><td><a name="l423" href="#l423">423</a><td> * test was waiting on, call continueTesting.<tr><td><a name="l424" href="#l424">424</a><td> */<tr><td><a name="l425" href="#l425">425</a><td>goog.testing.AsyncTestCase.prototype.signal = function() {<tr><td><a name="l426" href="#l426">426</a><td> if (++this.receivedSignalCount_ === this.expectedSignalCount_ &amp;&amp;<tr><td><a name="l427" href="#l427">427</a><td> this.expectedSignalCount_ &gt; 0) {<tr><td><a name="l428" href="#l428">428</a><td> this.endCurrentStep_();<tr><td><a name="l429" href="#l429">429</a><td> }<tr><td><a name="l430" href="#l430">430</a><td>};<tr><td><a name="l431" href="#l431">431</a><td><tr><td><a name="l432" href="#l432">432</a><td><tr><td><a name="l433" href="#l433">433</a><td>/**<tr><td><a name="l434" href="#l434">434</a><td> * Handles an exception thrown by a test.<tr><td><a name="l435" href="#l435">435</a><td> * @param {*=} opt_e The exception object associated with the failure<tr><td><a name="l436" href="#l436">436</a><td> * or a string.<tr><td><a name="l437" href="#l437">437</a><td> * @throws Always throws a ControlBreakingException.<tr><td><a name="l438" href="#l438">438</a><td> */<tr><td><a name="l439" href="#l439">439</a><td>goog.testing.AsyncTestCase.prototype.doAsyncError = function(opt_e) {<tr><td><a name="l440" href="#l440">440</a><td> // If we&#39;ve caught an exception that we threw, then just pass it along. This<tr><td><a name="l441" href="#l441">441</a><td> // can happen if doAsyncError() was called from a call to assert and then<tr><td><a name="l442" href="#l442">442</a><td> // again by pump_().<tr><td><a name="l443" href="#l443">443</a><td> if (opt_e &amp;&amp; opt_e.isControlBreakingException) {<tr><td><a name="l444" href="#l444">444</a><td> throw opt_e;<tr><td><a name="l445" href="#l445">445</a><td> }<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td> // Prevent another timeout error from triggering for this test step.<tr><td><a name="l448" href="#l448">448</a><td> this.stopTimeoutTimer_();<tr><td><a name="l449" href="#l449">449</a><td><tr><td><a name="l450" href="#l450">450</a><td> // doError() uses test.name. Here, we create a dummy test and give it a more<tr><td><a name="l451" href="#l451">451</a><td> // helpful name based on the step we&#39;re currently on.<tr><td><a name="l452" href="#l452">452</a><td> var fakeTestObj = new goog.testing.TestCase.Test(this.curStepName_,<tr><td><a name="l453" href="#l453">453</a><td> goog.nullFunction);<tr><td><a name="l454" href="#l454">454</a><td> if (this.activeTest) {<tr><td><a name="l455" href="#l455">455</a><td> fakeTestObj.name = this.activeTest.name + &#39; [&#39; + fakeTestObj.name + &#39;]&#39;;<tr><td><a name="l456" href="#l456">456</a><td> }<tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td> if (this.activeTest) {<tr><td><a name="l459" href="#l459">459</a><td> // Note: if the test has an error, and then tearDown has an error, they will<tr><td><a name="l460" href="#l460">460</a><td> // both be reported.<tr><td><a name="l461" href="#l461">461</a><td> this.doError(fakeTestObj, opt_e);<tr><td><a name="l462" href="#l462">462</a><td> } else {<tr><td><a name="l463" href="#l463">463</a><td> this.exceptionBeforeTest = opt_e;<tr><td><a name="l464" href="#l464">464</a><td> }<tr><td><a name="l465" href="#l465">465</a><td><tr><td><a name="l466" href="#l466">466</a><td> // This is a potential entry point, so we pump. We also add in a bit of a<tr><td><a name="l467" href="#l467">467</a><td> // delay to try and prevent any async behavior from the failed test from<tr><td><a name="l468" href="#l468">468</a><td> // causing the next test to fail.<tr><td><a name="l469" href="#l469">469</a><td> this.timeout(goog.bind(this.pump_, this, this.doAsyncErrorTearDown_),<tr><td><a name="l470" href="#l470">470</a><td> this.timeToSleepAfterFailure);<tr><td><a name="l471" href="#l471">471</a><td><tr><td><a name="l472" href="#l472">472</a><td> // We just caught an exception, so we do not want the code above us on the<tr><td><a name="l473" href="#l473">473</a><td> // stack to continue executing. If pump_ is in our call-stack, then it will<tr><td><a name="l474" href="#l474">474</a><td> // batch together multiple errors, so we only increment the count if pump_ is<tr><td><a name="l475" href="#l475">475</a><td> // not in the stack and let pump_ increment the count when it batches them.<tr><td><a name="l476" href="#l476">476</a><td> if (!this.returnWillPump_) {<tr><td><a name="l477" href="#l477">477</a><td> this.numControlExceptionsExpected_ += 1;<tr><td><a name="l478" href="#l478">478</a><td> this.dbgLog_(&#39;doAsynError: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l479" href="#l479">479</a><td> this.numControlExceptionsExpected_ + &#39; and throwing exception.&#39;);<tr><td><a name="l480" href="#l480">480</a><td> }<tr><td><a name="l481" href="#l481">481</a><td><tr><td><a name="l482" href="#l482">482</a><td> // Copy the error message to ControlBreakingException.<tr><td><a name="l483" href="#l483">483</a><td> var message = &#39;&#39;;<tr><td><a name="l484" href="#l484">484</a><td> if (typeof opt_e == &#39;string&#39;) {<tr><td><a name="l485" href="#l485">485</a><td> message = opt_e;<tr><td><a name="l486" href="#l486">486</a><td> } else if (opt_e &amp;&amp; opt_e.message) {<tr><td><a name="l487" href="#l487">487</a><td> message = opt_e.message;<tr><td><a name="l488" href="#l488">488</a><td> }<tr><td><a name="l489" href="#l489">489</a><td> throw new goog.testing.AsyncTestCase.ControlBreakingException(message);<tr><td><a name="l490" href="#l490">490</a><td>};<tr><td><a name="l491" href="#l491">491</a><td><tr><td><a name="l492" href="#l492">492</a><td><tr><td><a name="l493" href="#l493">493</a><td>/**<tr><td><a name="l494" href="#l494">494</a><td> * Sets up the test page and then waits until the test case has been marked<tr><td><a name="l495" href="#l495">495</a><td> * as ready before executing the tests.<tr><td><a name="l496" href="#l496">496</a><td> * @override<tr><td><a name="l497" href="#l497">497</a><td> */<tr><td><a name="l498" href="#l498">498</a><td>goog.testing.AsyncTestCase.prototype.runTests = function() {<tr><td><a name="l499" href="#l499">499</a><td> this.hookAssert_();<tr><td><a name="l500" href="#l500">500</a><td> this.hookOnError_();<tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td> this.setNextStep_(this.doSetUpPage_, &#39;setUpPage&#39;);<tr><td><a name="l503" href="#l503">503</a><td> // We are an entry point, so we pump.<tr><td><a name="l504" href="#l504">504</a><td> this.pump_();<tr><td><a name="l505" href="#l505">505</a><td>};<tr><td><a name="l506" href="#l506">506</a><td><tr><td><a name="l507" href="#l507">507</a><td><tr><td><a name="l508" href="#l508">508</a><td>/**<tr><td><a name="l509" href="#l509">509</a><td> * Starts the tests.<tr><td><a name="l510" href="#l510">510</a><td> * @override<tr><td><a name="l511" href="#l511">511</a><td> */<tr><td><a name="l512" href="#l512">512</a><td>goog.testing.AsyncTestCase.prototype.cycleTests = function() {<tr><td><a name="l513" href="#l513">513</a><td> // We are an entry point, so we pump.<tr><td><a name="l514" href="#l514">514</a><td> this.saveMessage(&#39;Start&#39;);<tr><td><a name="l515" href="#l515">515</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l516" href="#l516">516</a><td> this.pump_();<tr><td><a name="l517" href="#l517">517</a><td>};<tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td><tr><td><a name="l520" href="#l520">520</a><td>/**<tr><td><a name="l521" href="#l521">521</a><td> * Finalizes the test case, called when the tests have finished executing.<tr><td><a name="l522" href="#l522">522</a><td> * @override<tr><td><a name="l523" href="#l523">523</a><td> */<tr><td><a name="l524" href="#l524">524</a><td>goog.testing.AsyncTestCase.prototype.finalize = function() {<tr><td><a name="l525" href="#l525">525</a><td> this.unhookAll_();<tr><td><a name="l526" href="#l526">526</a><td> this.setNextStep_(null, &#39;finalized&#39;);<tr><td><a name="l527" href="#l527">527</a><td> goog.testing.AsyncTestCase.superClass_.finalize.call(this);<tr><td><a name="l528" href="#l528">528</a><td>};<tr><td><a name="l529" href="#l529">529</a><td><tr><td><a name="l530" href="#l530">530</a><td><tr><td><a name="l531" href="#l531">531</a><td>/**<tr><td><a name="l532" href="#l532">532</a><td> * Enables verbose logging of what is happening inside of the AsyncTestCase.<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogging = function() {<tr><td><a name="l535" href="#l535">535</a><td> this.enableDebugLogs_ = true;<tr><td><a name="l536" href="#l536">536</a><td>};<tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td><tr><td><a name="l539" href="#l539">539</a><td>/**<tr><td><a name="l540" href="#l540">540</a><td> * Logs the given debug message to the console (when enabled).<tr><td><a name="l541" href="#l541">541</a><td> * @param {string} message The message to log.<tr><td><a name="l542" href="#l542">542</a><td> * @private<tr><td><a name="l543" href="#l543">543</a><td> */<tr><td><a name="l544" href="#l544">544</a><td>goog.testing.AsyncTestCase.prototype.dbgLog_ = function(message) {<tr><td><a name="l545" href="#l545">545</a><td> if (this.enableDebugLogs_) {<tr><td><a name="l546" href="#l546">546</a><td> this.log(&#39;AsyncTestCase - &#39; + message);<tr><td><a name="l547" href="#l547">547</a><td> }<tr><td><a name="l548" href="#l548">548</a><td>};<tr><td><a name="l549" href="#l549">549</a><td><tr><td><a name="l550" href="#l550">550</a><td><tr><td><a name="l551" href="#l551">551</a><td>/**<tr><td><a name="l552" href="#l552">552</a><td> * Wraps doAsyncError() for when we are sure that the test runner has no user<tr><td><a name="l553" href="#l553">553</a><td> * code above it in the stack.<tr><td><a name="l554" href="#l554">554</a><td> * @param {string|Error=} opt_e The exception object associated with the<tr><td><a name="l555" href="#l555">555</a><td> * failure or a string.<tr><td><a name="l556" href="#l556">556</a><td> * @private<tr><td><a name="l557" href="#l557">557</a><td> */<tr><td><a name="l558" href="#l558">558</a><td>goog.testing.AsyncTestCase.prototype.doTopOfStackAsyncError_ =<tr><td><a name="l559" href="#l559">559</a><td> function(opt_e) {<tr><td><a name="l560" href="#l560">560</a><td> /** @preserveTry */<tr><td><a name="l561" href="#l561">561</a><td> try {<tr><td><a name="l562" href="#l562">562</a><td> this.doAsyncError(opt_e);<tr><td><a name="l563" href="#l563">563</a><td> } catch (e) {<tr><td><a name="l564" href="#l564">564</a><td> // We know that we are on the top of the stack, so there is no need to<tr><td><a name="l565" href="#l565">565</a><td> // throw this exception in this case.<tr><td><a name="l566" href="#l566">566</a><td> if (e.isControlBreakingException) {<tr><td><a name="l567" href="#l567">567</a><td> this.numControlExceptionsExpected_ -= 1;<tr><td><a name="l568" href="#l568">568</a><td> this.dbgLog_(&#39;doTopOfStackAsyncError_: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l569" href="#l569">569</a><td> this.numControlExceptionsExpected_ + &#39; and catching exception.&#39;);<tr><td><a name="l570" href="#l570">570</a><td> } else {<tr><td><a name="l571" href="#l571">571</a><td> throw e;<tr><td><a name="l572" href="#l572">572</a><td> }<tr><td><a name="l573" href="#l573">573</a><td> }<tr><td><a name="l574" href="#l574">574</a><td>};<tr><td><a name="l575" href="#l575">575</a><td><tr><td><a name="l576" href="#l576">576</a><td><tr><td><a name="l577" href="#l577">577</a><td>/**<tr><td><a name="l578" href="#l578">578</a><td> * Calls the tearDown function, catching any errors, and then moves on to<tr><td><a name="l579" href="#l579">579</a><td> * the next step in the testing cycle.<tr><td><a name="l580" href="#l580">580</a><td> * @private<tr><td><a name="l581" href="#l581">581</a><td> */<tr><td><a name="l582" href="#l582">582</a><td>goog.testing.AsyncTestCase.prototype.doAsyncErrorTearDown_ = function() {<tr><td><a name="l583" href="#l583">583</a><td> if (this.inException_) {<tr><td><a name="l584" href="#l584">584</a><td> // We get here if tearDown is throwing the error.<tr><td><a name="l585" href="#l585">585</a><td> // Upon calling continueTesting, the inline function &#39;doAsyncError&#39; (set<tr><td><a name="l586" href="#l586">586</a><td> // below) is run.<tr><td><a name="l587" href="#l587">587</a><td> this.endCurrentStep_();<tr><td><a name="l588" href="#l588">588</a><td> } else {<tr><td><a name="l589" href="#l589">589</a><td> this.inException_ = true;<tr><td><a name="l590" href="#l590">590</a><td> this.isReady_ = true;<tr><td><a name="l591" href="#l591">591</a><td><tr><td><a name="l592" href="#l592">592</a><td> // The continue point is different depending on if the error happened in<tr><td><a name="l593" href="#l593">593</a><td> // setUpPage() or in setUp()/test*()/tearDown().<tr><td><a name="l594" href="#l594">594</a><td> var stepFuncAfterError = this.nextStepFunc_;<tr><td><a name="l595" href="#l595">595</a><td> var stepNameAfterError = &#39;TestCase.execute (after error)&#39;;<tr><td><a name="l596" href="#l596">596</a><td> if (this.activeTest) {<tr><td><a name="l597" href="#l597">597</a><td> stepFuncAfterError = this.doIteration_;<tr><td><a name="l598" href="#l598">598</a><td> stepNameAfterError = &#39;doIteration (after error)&#39;;<tr><td><a name="l599" href="#l599">599</a><td> }<tr><td><a name="l600" href="#l600">600</a><td><tr><td><a name="l601" href="#l601">601</a><td> // We must set the next step before calling tearDown.<tr><td><a name="l602" href="#l602">602</a><td> this.setNextStep_(function() {<tr><td><a name="l603" href="#l603">603</a><td> this.inException_ = false;<tr><td><a name="l604" href="#l604">604</a><td> // This is null when an error happens in setUpPage.<tr><td><a name="l605" href="#l605">605</a><td> this.setNextStep_(stepFuncAfterError, stepNameAfterError);<tr><td><a name="l606" href="#l606">606</a><td> }, &#39;doAsyncError&#39;);<tr><td><a name="l607" href="#l607">607</a><td><tr><td><a name="l608" href="#l608">608</a><td> // Call the test&#39;s tearDown().<tr><td><a name="l609" href="#l609">609</a><td> if (!this.cleanedUp_) {<tr><td><a name="l610" href="#l610">610</a><td> this.cleanedUp_ = true;<tr><td><a name="l611" href="#l611">611</a><td> this.tearDown();<tr><td><a name="l612" href="#l612">612</a><td> }<tr><td><a name="l613" href="#l613">613</a><td> }<tr><td><a name="l614" href="#l614">614</a><td>};<tr><td><a name="l615" href="#l615">615</a><td><tr><td><a name="l616" href="#l616">616</a><td><tr><td><a name="l617" href="#l617">617</a><td>/**<tr><td><a name="l618" href="#l618">618</a><td> * Replaces the asserts.js assert_() and fail() functions with a wrappers to<tr><td><a name="l619" href="#l619">619</a><td> * catch the exceptions.<tr><td><a name="l620" href="#l620">620</a><td> * @private<tr><td><a name="l621" href="#l621">621</a><td> */<tr><td><a name="l622" href="#l622">622</a><td>goog.testing.AsyncTestCase.prototype.hookAssert_ = function() {<tr><td><a name="l623" href="#l623">623</a><td> if (!this.origAssert_) {<tr><td><a name="l624" href="#l624">624</a><td> this.origAssert_ = _assert;<tr><td><a name="l625" href="#l625">625</a><td> this.origFail_ = fail;<tr><td><a name="l626" href="#l626">626</a><td> var self = this;<tr><td><a name="l627" href="#l627">627</a><td> _assert = function() {<tr><td><a name="l628" href="#l628">628</a><td> /** @preserveTry */<tr><td><a name="l629" href="#l629">629</a><td> try {<tr><td><a name="l630" href="#l630">630</a><td> self.origAssert_.apply(this, arguments);<tr><td><a name="l631" href="#l631">631</a><td> } catch (e) {<tr><td><a name="l632" href="#l632">632</a><td> self.dbgLog_(&#39;Wrapping failed assert()&#39;);<tr><td><a name="l633" href="#l633">633</a><td> self.doAsyncError(e);<tr><td><a name="l634" href="#l634">634</a><td> }<tr><td><a name="l635" href="#l635">635</a><td> };<tr><td><a name="l636" href="#l636">636</a><td> fail = function() {<tr><td><a name="l637" href="#l637">637</a><td> /** @preserveTry */<tr><td><a name="l638" href="#l638">638</a><td> try {<tr><td><a name="l639" href="#l639">639</a><td> self.origFail_.apply(this, arguments);<tr><td><a name="l640" href="#l640">640</a><td> } catch (e) {<tr><td><a name="l641" href="#l641">641</a><td> self.dbgLog_(&#39;Wrapping fail()&#39;);<tr><td><a name="l642" href="#l642">642</a><td> self.doAsyncError(e);<tr><td><a name="l643" href="#l643">643</a><td> }<tr><td><a name="l644" href="#l644">644</a><td> };<tr><td><a name="l645" href="#l645">645</a><td> }<tr><td><a name="l646" href="#l646">646</a><td>};<tr><td><a name="l647" href="#l647">647</a><td><tr><td><a name="l648" href="#l648">648</a><td><tr><td><a name="l649" href="#l649">649</a><td>/**<tr><td><a name="l650" href="#l650">650</a><td> * Sets a window.onerror handler for catching exceptions that happen in async<tr><td><a name="l651" href="#l651">651</a><td> * callbacks. Note that as of Safari 3.1, Safari does not support this.<tr><td><a name="l652" href="#l652">652</a><td> * @private<tr><td><a name="l653" href="#l653">653</a><td> */<tr><td><a name="l654" href="#l654">654</a><td>goog.testing.AsyncTestCase.prototype.hookOnError_ = function() {<tr><td><a name="l655" href="#l655">655</a><td> if (!this.origOnError_) {<tr><td><a name="l656" href="#l656">656</a><td> this.origOnError_ = window.onerror;<tr><td><a name="l657" href="#l657">657</a><td> var self = this;<tr><td><a name="l658" href="#l658">658</a><td> window.onerror = function(error, url, line) {<tr><td><a name="l659" href="#l659">659</a><td> // Ignore exceptions that we threw on purpose.<tr><td><a name="l660" href="#l660">660</a><td> var cbe =<tr><td><a name="l661" href="#l661">661</a><td> goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l662" href="#l662">662</a><td> if (String(error).indexOf(cbe) != -1 &amp;&amp;<tr><td><a name="l663" href="#l663">663</a><td> self.numControlExceptionsExpected_) {<tr><td><a name="l664" href="#l664">664</a><td> self.numControlExceptionsExpected_ -= 1;<tr><td><a name="l665" href="#l665">665</a><td> self.dbgLog_(&#39;window.onerror: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l666" href="#l666">666</a><td> self.numControlExceptionsExpected_ + &#39; and ignoring exception. &#39; +<tr><td><a name="l667" href="#l667">667</a><td> error);<tr><td><a name="l668" href="#l668">668</a><td> // Tell the browser not to compain about the error.<tr><td><a name="l669" href="#l669">669</a><td> return true;<tr><td><a name="l670" href="#l670">670</a><td> } else {<tr><td><a name="l671" href="#l671">671</a><td> self.dbgLog_(&#39;window.onerror caught exception.&#39;);<tr><td><a name="l672" href="#l672">672</a><td> var message = error + &#39;\nURL: &#39; + url + &#39;\nLine: &#39; + line;<tr><td><a name="l673" href="#l673">673</a><td> self.doTopOfStackAsyncError_(message);<tr><td><a name="l674" href="#l674">674</a><td> // Tell the browser to complain about the error.<tr><td><a name="l675" href="#l675">675</a><td> return false;<tr><td><a name="l676" href="#l676">676</a><td> }<tr><td><a name="l677" href="#l677">677</a><td> };<tr><td><a name="l678" href="#l678">678</a><td> }<tr><td><a name="l679" href="#l679">679</a><td>};<tr><td><a name="l680" href="#l680">680</a><td><tr><td><a name="l681" href="#l681">681</a><td><tr><td><a name="l682" href="#l682">682</a><td>/**<tr><td><a name="l683" href="#l683">683</a><td> * Unhooks window.onerror and _assert.<tr><td><a name="l684" href="#l684">684</a><td> * @private<tr><td><a name="l685" href="#l685">685</a><td> */<tr><td><a name="l686" href="#l686">686</a><td>goog.testing.AsyncTestCase.prototype.unhookAll_ = function() {<tr><td><a name="l687" href="#l687">687</a><td> if (this.origOnError_) {<tr><td><a name="l688" href="#l688">688</a><td> window.onerror = this.origOnError_;<tr><td><a name="l689" href="#l689">689</a><td> this.origOnError_ = null;<tr><td><a name="l690" href="#l690">690</a><td> _assert = this.origAssert_;<tr><td><a name="l691" href="#l691">691</a><td> this.origAssert_ = null;<tr><td><a name="l692" href="#l692">692</a><td> fail = this.origFail_;<tr><td><a name="l693" href="#l693">693</a><td> this.origFail_ = null;<tr><td><a name="l694" href="#l694">694</a><td> }<tr><td><a name="l695" href="#l695">695</a><td>};<tr><td><a name="l696" href="#l696">696</a><td><tr><td><a name="l697" href="#l697">697</a><td><tr><td><a name="l698" href="#l698">698</a><td>/**<tr><td><a name="l699" href="#l699">699</a><td> * Enables the timeout timer. This timer fires unless continueTesting is<tr><td><a name="l700" href="#l700">700</a><td> * called.<tr><td><a name="l701" href="#l701">701</a><td> * @private<tr><td><a name="l702" href="#l702">702</a><td> */<tr><td><a name="l703" href="#l703">703</a><td>goog.testing.AsyncTestCase.prototype.startTimeoutTimer_ = function() {<tr><td><a name="l704" href="#l704">704</a><td> if (!this.timeoutHandle_ &amp;&amp; this.stepTimeout &gt; 0) {<tr><td><a name="l705" href="#l705">705</a><td> this.timeoutHandle_ = this.timeout(goog.bind(function() {<tr><td><a name="l706" href="#l706">706</a><td> this.dbgLog_(&#39;Timeout timer fired with id &#39; + this.timeoutHandle_);<tr><td><a name="l707" href="#l707">707</a><td> this.timeoutHandle_ = 0;<tr><td><a name="l708" href="#l708">708</a><td><tr><td><a name="l709" href="#l709">709</a><td> this.doTopOfStackAsyncError_(&#39;Timed out while waiting for &#39; +<tr><td><a name="l710" href="#l710">710</a><td> &#39;continueTesting() to be called.&#39;);<tr><td><a name="l711" href="#l711">711</a><td> }, this, null), this.stepTimeout);<tr><td><a name="l712" href="#l712">712</a><td> this.dbgLog_(&#39;Started timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l713" href="#l713">713</a><td> }<tr><td><a name="l714" href="#l714">714</a><td>};<tr><td><a name="l715" href="#l715">715</a><td><tr><td><a name="l716" href="#l716">716</a><td><tr><td><a name="l717" href="#l717">717</a><td>/**<tr><td><a name="l718" href="#l718">718</a><td> * Disables the timeout timer.<tr><td><a name="l719" href="#l719">719</a><td> * @private<tr><td><a name="l720" href="#l720">720</a><td> */<tr><td><a name="l721" href="#l721">721</a><td>goog.testing.AsyncTestCase.prototype.stopTimeoutTimer_ = function() {<tr><td><a name="l722" href="#l722">722</a><td> if (this.timeoutHandle_) {<tr><td><a name="l723" href="#l723">723</a><td> this.dbgLog_(&#39;Clearing timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l724" href="#l724">724</a><td> this.clearTimeout(this.timeoutHandle_);<tr><td><a name="l725" href="#l725">725</a><td> this.timeoutHandle_ = 0;<tr><td><a name="l726" href="#l726">726</a><td> }<tr><td><a name="l727" href="#l727">727</a><td>};<tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td><tr><td><a name="l730" href="#l730">730</a><td>/**<tr><td><a name="l731" href="#l731">731</a><td> * Sets the next function to call in our sequence of async callbacks.<tr><td><a name="l732" href="#l732">732</a><td> * @param {Function} func The function that executes the next step.<tr><td><a name="l733" href="#l733">733</a><td> * @param {string} name A description of the next step.<tr><td><a name="l734" href="#l734">734</a><td> * @private<tr><td><a name="l735" href="#l735">735</a><td> */<tr><td><a name="l736" href="#l736">736</a><td>goog.testing.AsyncTestCase.prototype.setNextStep_ = function(func, name) {<tr><td><a name="l737" href="#l737">737</a><td> this.nextStepFunc_ = func &amp;&amp; goog.bind(func, this);<tr><td><a name="l738" href="#l738">738</a><td> this.nextStepName_ = name;<tr><td><a name="l739" href="#l739">739</a><td>};<tr><td><a name="l740" href="#l740">740</a><td><tr><td><a name="l741" href="#l741">741</a><td><tr><td><a name="l742" href="#l742">742</a><td>/**<tr><td><a name="l743" href="#l743">743</a><td> * Calls the given function, redirecting any exceptions to doAsyncError.<tr><td><a name="l744" href="#l744">744</a><td> * @param {Function} func The function to call.<tr><td><a name="l745" href="#l745">745</a><td> * @return {!goog.testing.AsyncTestCase.TopStackFuncResult_} Returns a<tr><td><a name="l746" href="#l746">746</a><td> * TopStackFuncResult_.<tr><td><a name="l747" href="#l747">747</a><td> * @private<tr><td><a name="l748" href="#l748">748</a><td> */<tr><td><a name="l749" href="#l749">749</a><td>goog.testing.AsyncTestCase.prototype.callTopOfStackFunc_ = function(func) {<tr><td><a name="l750" href="#l750">750</a><td> /** @preserveTry */<tr><td><a name="l751" href="#l751">751</a><td> try {<tr><td><a name="l752" href="#l752">752</a><td> func.call(this);<tr><td><a name="l753" href="#l753">753</a><td> return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l754" href="#l754">754</a><td> } catch (e) {<tr><td><a name="l755" href="#l755">755</a><td> this.dbgLog_(&#39;Caught exception in callTopOfStackFunc_&#39;);<tr><td><a name="l756" href="#l756">756</a><td> /** @preserveTry */<tr><td><a name="l757" href="#l757">757</a><td> try {<tr><td><a name="l758" href="#l758">758</a><td> this.doAsyncError(e);<tr><td><a name="l759" href="#l759">759</a><td> return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l760" href="#l760">760</a><td> } catch (e2) {<tr><td><a name="l761" href="#l761">761</a><td> if (!e2.isControlBreakingException) {<tr><td><a name="l762" href="#l762">762</a><td> throw e2;<tr><td><a name="l763" href="#l763">763</a><td> }<tr><td><a name="l764" href="#l764">764</a><td> return {controlBreakingExceptionThrown: true, message: e2.message};<tr><td><a name="l765" href="#l765">765</a><td> }<tr><td><a name="l766" href="#l766">766</a><td> }<tr><td><a name="l767" href="#l767">767</a><td>};<tr><td><a name="l768" href="#l768">768</a><td><tr><td><a name="l769" href="#l769">769</a><td><tr><td><a name="l770" href="#l770">770</a><td>/**<tr><td><a name="l771" href="#l771">771</a><td> * Calls the next callback when the isReady_ flag is true.<tr><td><a name="l772" href="#l772">772</a><td> * @param {Function=} opt_doFirst A function to call before pumping.<tr><td><a name="l773" href="#l773">773</a><td> * @private<tr><td><a name="l774" href="#l774">774</a><td> * @throws Throws a ControlBreakingException if there were any failing steps.<tr><td><a name="l775" href="#l775">775</a><td> */<tr><td><a name="l776" href="#l776">776</a><td>goog.testing.AsyncTestCase.prototype.pump_ = function(opt_doFirst) {<tr><td><a name="l777" href="#l777">777</a><td> // If this function is already above us in the call-stack, then we should<tr><td><a name="l778" href="#l778">778</a><td> // return rather than pumping in order to minimize call-stack depth.<tr><td><a name="l779" href="#l779">779</a><td> if (!this.returnWillPump_) {<tr><td><a name="l780" href="#l780">780</a><td> this.setBatchTime(this.now());<tr><td><a name="l781" href="#l781">781</a><td> this.returnWillPump_ = true;<tr><td><a name="l782" href="#l782">782</a><td> var topFuncResult = {};<tr><td><a name="l783" href="#l783">783</a><td><tr><td><a name="l784" href="#l784">784</a><td> if (opt_doFirst) {<tr><td><a name="l785" href="#l785">785</a><td> topFuncResult = this.callTopOfStackFunc_(opt_doFirst);<tr><td><a name="l786" href="#l786">786</a><td> }<tr><td><a name="l787" href="#l787">787</a><td> // Note: we don&#39;t check for this.running here because it is not set to true<tr><td><a name="l788" href="#l788">788</a><td> // while executing setUpPage and tearDownPage.<tr><td><a name="l789" href="#l789">789</a><td> // Also, if isReady_ is false, then one of two things will happen:<tr><td><a name="l790" href="#l790">790</a><td> // 1. Our timeout callback will be called.<tr><td><a name="l791" href="#l791">791</a><td> // 2. The tests will call continueTesting(), which will call pump_() again.<tr><td><a name="l792" href="#l792">792</a><td> while (this.isReady_ &amp;&amp; this.nextStepFunc_ &amp;&amp;<tr><td><a name="l793" href="#l793">793</a><td> !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l794" href="#l794">794</a><td> this.curStepFunc_ = this.nextStepFunc_;<tr><td><a name="l795" href="#l795">795</a><td> this.curStepName_ = this.nextStepName_;<tr><td><a name="l796" href="#l796">796</a><td> this.nextStepFunc_ = null;<tr><td><a name="l797" href="#l797">797</a><td> this.nextStepName_ = &#39;&#39;;<tr><td><a name="l798" href="#l798">798</a><td><tr><td><a name="l799" href="#l799">799</a><td> this.dbgLog_(&#39;Performing step: &#39; + this.curStepName_);<tr><td><a name="l800" href="#l800">800</a><td> topFuncResult =<tr><td><a name="l801" href="#l801">801</a><td> this.callTopOfStackFunc_(/** @type {Function} */(this.curStepFunc_));<tr><td><a name="l802" href="#l802">802</a><td><tr><td><a name="l803" href="#l803">803</a><td> // If the max run time is exceeded call this function again async so as<tr><td><a name="l804" href="#l804">804</a><td> // not to block the browser.<tr><td><a name="l805" href="#l805">805</a><td> var delta = this.now() - this.getBatchTime();<tr><td><a name="l806" href="#l806">806</a><td> if (delta &gt; goog.testing.TestCase.maxRunTime &amp;&amp;<tr><td><a name="l807" href="#l807">807</a><td> !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l808" href="#l808">808</a><td> this.saveMessage(&#39;Breaking async&#39;);<tr><td><a name="l809" href="#l809">809</a><td> var self = this;<tr><td><a name="l810" href="#l810">810</a><td> this.timeout(function() { self.pump_(); }, 100);<tr><td><a name="l811" href="#l811">811</a><td> break;<tr><td><a name="l812" href="#l812">812</a><td> }<tr><td><a name="l813" href="#l813">813</a><td> }<tr><td><a name="l814" href="#l814">814</a><td> this.returnWillPump_ = false;<tr><td><a name="l815" href="#l815">815</a><td> } else if (opt_doFirst) {<tr><td><a name="l816" href="#l816">816</a><td> opt_doFirst.call(this);<tr><td><a name="l817" href="#l817">817</a><td> }<tr><td><a name="l818" href="#l818">818</a><td>};<tr><td><a name="l819" href="#l819">819</a><td><tr><td><a name="l820" href="#l820">820</a><td><tr><td><a name="l821" href="#l821">821</a><td>/**<tr><td><a name="l822" href="#l822">822</a><td> * Sets up the test page and then waits untill the test case has been marked<tr><td><a name="l823" href="#l823">823</a><td> * as ready before executing the tests.<tr><td><a name="l824" href="#l824">824</a><td> * @private<tr><td><a name="l825" href="#l825">825</a><td> */<tr><td><a name="l826" href="#l826">826</a><td>goog.testing.AsyncTestCase.prototype.doSetUpPage_ = function() {<tr><td><a name="l827" href="#l827">827</a><td> this.setNextStep_(this.execute, &#39;TestCase.execute&#39;);<tr><td><a name="l828" href="#l828">828</a><td> this.setUpPage();<tr><td><a name="l829" href="#l829">829</a><td>};<tr><td><a name="l830" href="#l830">830</a><td><tr><td><a name="l831" href="#l831">831</a><td><tr><td><a name="l832" href="#l832">832</a><td>/**<tr><td><a name="l833" href="#l833">833</a><td> * Step 1: Move to the next test.<tr><td><a name="l834" href="#l834">834</a><td> * @private<tr><td><a name="l835" href="#l835">835</a><td> */<tr><td><a name="l836" href="#l836">836</a><td>goog.testing.AsyncTestCase.prototype.doIteration_ = function() {<tr><td><a name="l837" href="#l837">837</a><td> this.expectedSignalCount_ = 0;<tr><td><a name="l838" href="#l838">838</a><td> this.receivedSignalCount_ = 0;<tr><td><a name="l839" href="#l839">839</a><td> this.activeTest = this.next();<tr><td><a name="l840" href="#l840">840</a><td> if (this.activeTest &amp;&amp; this.running) {<tr><td><a name="l841" href="#l841">841</a><td> this.result_.runCount++;<tr><td><a name="l842" href="#l842">842</a><td> // If this test should be marked as having failed, doIteration will go<tr><td><a name="l843" href="#l843">843</a><td> // straight to the next test.<tr><td><a name="l844" href="#l844">844</a><td> if (this.maybeFailTestEarly(this.activeTest)) {<tr><td><a name="l845" href="#l845">845</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l846" href="#l846">846</a><td> } else {<tr><td><a name="l847" href="#l847">847</a><td> this.setNextStep_(this.doSetUp_, &#39;setUp&#39;);<tr><td><a name="l848" href="#l848">848</a><td> }<tr><td><a name="l849" href="#l849">849</a><td> } else {<tr><td><a name="l850" href="#l850">850</a><td> // All tests done.<tr><td><a name="l851" href="#l851">851</a><td> this.finalize();<tr><td><a name="l852" href="#l852">852</a><td> }<tr><td><a name="l853" href="#l853">853</a><td>};<tr><td><a name="l854" href="#l854">854</a><td><tr><td><a name="l855" href="#l855">855</a><td><tr><td><a name="l856" href="#l856">856</a><td>/**<tr><td><a name="l857" href="#l857">857</a><td> * Step 2: Call setUp().<tr><td><a name="l858" href="#l858">858</a><td> * @private<tr><td><a name="l859" href="#l859">859</a><td> */<tr><td><a name="l860" href="#l860">860</a><td>goog.testing.AsyncTestCase.prototype.doSetUp_ = function() {<tr><td><a name="l861" href="#l861">861</a><td> this.log(&#39;Running test: &#39; + this.activeTest.name);<tr><td><a name="l862" href="#l862">862</a><td> this.cleanedUp_ = false;<tr><td><a name="l863" href="#l863">863</a><td> this.setNextStep_(this.doExecute_, this.activeTest.name);<tr><td><a name="l864" href="#l864">864</a><td> this.setUp();<tr><td><a name="l865" href="#l865">865</a><td>};<tr><td><a name="l866" href="#l866">866</a><td><tr><td><a name="l867" href="#l867">867</a><td><tr><td><a name="l868" href="#l868">868</a><td>/**<tr><td><a name="l869" href="#l869">869</a><td> * Step 3: Call test.execute().<tr><td><a name="l870" href="#l870">870</a><td> * @private<tr><td><a name="l871" href="#l871">871</a><td> */<tr><td><a name="l872" href="#l872">872</a><td>goog.testing.AsyncTestCase.prototype.doExecute_ = function() {<tr><td><a name="l873" href="#l873">873</a><td> this.setNextStep_(this.doTearDown_, &#39;tearDown&#39;);<tr><td><a name="l874" href="#l874">874</a><td> this.activeTest.execute();<tr><td><a name="l875" href="#l875">875</a><td>};<tr><td><a name="l876" href="#l876">876</a><td><tr><td><a name="l877" href="#l877">877</a><td><tr><td><a name="l878" href="#l878">878</a><td>/**<tr><td><a name="l879" href="#l879">879</a><td> * Step 4: Call tearDown().<tr><td><a name="l880" href="#l880">880</a><td> * @private<tr><td><a name="l881" href="#l881">881</a><td> */<tr><td><a name="l882" href="#l882">882</a><td>goog.testing.AsyncTestCase.prototype.doTearDown_ = function() {<tr><td><a name="l883" href="#l883">883</a><td> this.cleanedUp_ = true;<tr><td><a name="l884" href="#l884">884</a><td> this.setNextStep_(this.doNext_, &#39;doNext&#39;);<tr><td><a name="l885" href="#l885">885</a><td> this.tearDown();<tr><td><a name="l886" href="#l886">886</a><td>};<tr><td><a name="l887" href="#l887">887</a><td><tr><td><a name="l888" href="#l888">888</a><td><tr><td><a name="l889" href="#l889">889</a><td>/**<tr><td><a name="l890" href="#l890">890</a><td> * Step 5: Call doSuccess()<tr><td><a name="l891" href="#l891">891</a><td> * @private<tr><td><a name="l892" href="#l892">892</a><td> */<tr><td><a name="l893" href="#l893">893</a><td>goog.testing.AsyncTestCase.prototype.doNext_ = function() {<tr><td><a name="l894" href="#l894">894</a><td> this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l895" href="#l895">895</a><td> this.doSuccess(/** @type {goog.testing.TestCase.Test} */(this.activeTest));<tr><td><a name="l896" href="#l896">896</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="../../../../license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>