selenium-webdriver 2.47.0 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/CHANGES.md +96 -0
  2. package/NOTICE +1 -1
  3. package/README.md +57 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +80 -114
  12. package/firefox/extension.js +10 -19
  13. package/firefox/index.js +175 -171
  14. package/firefox/profile.js +221 -239
  15. package/http/index.js +396 -77
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +89 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +6 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/promise.js +3093 -0
  34. package/lib/safari/client.js +697 -659
  35. package/lib/session.js +79 -0
  36. package/{test/promise_aplus_test.js → lib/symbols.js} +15 -25
  37. package/lib/test/build.js +4 -4
  38. package/lib/test/data/click_tests/disappearing_element.html +62 -0
  39. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  40. package/lib/test/data/click_tests/overlapping_elements.html +70 -0
  41. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  42. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  43. package/lib/test/data/readOnlyPage.html +3 -1
  44. package/lib/test/data/selectPage.html +18 -2
  45. package/lib/test/data/simpleTest.html +1 -0
  46. package/lib/test/fileserver.js +3 -4
  47. package/lib/test/index.js +13 -4
  48. package/lib/test/resources.js +1 -1
  49. package/lib/until.js +428 -0
  50. package/lib/webdriver.js +2351 -0
  51. package/net/portprober.js +15 -11
  52. package/opera.js +295 -314
  53. package/package.json +6 -5
  54. package/phantomjs.js +135 -140
  55. package/proxy.js +6 -4
  56. package/remote/index.js +234 -219
  57. package/safari.js +319 -310
  58. package/test/chrome/options_test.js +11 -9
  59. package/test/element_finding_test.js +51 -13
  60. package/test/error_test.js +163 -0
  61. package/test/execute_script_test.js +1 -1
  62. package/test/firefox/firefox_test.js +24 -0
  63. package/test/http/http_test.js +354 -43
  64. package/test/http/util_test.js +25 -23
  65. package/test/io_test.js +6 -1
  66. package/test/lib/by_test.js +127 -0
  67. package/test/lib/capabilities_test.js +84 -0
  68. package/test/lib/events_test.js +177 -0
  69. package/test/lib/logging_test.js +272 -0
  70. package/test/lib/promise_aplus_test.js +74 -0
  71. package/test/lib/promise_error_test.js +808 -0
  72. package/test/lib/promise_flow_test.js +2282 -0
  73. package/test/lib/promise_generator_test.js +308 -0
  74. package/test/lib/promise_test.js +996 -0
  75. package/test/lib/testutil.js +90 -0
  76. package/test/lib/until_test.js +436 -0
  77. package/test/lib/webdriver_test.js +2207 -0
  78. package/test/page_loading_test.js +7 -9
  79. package/test/stale_element_test.js +2 -2
  80. package/test/testing/assert_test.js +374 -0
  81. package/test/testing/index_test.js +9 -11
  82. package/testing/assert.js +334 -17
  83. package/testing/index.js +10 -0
  84. package/_base.js +0 -200
  85. package/docs/Changes.html +0 -317
  86. package/docs/class_bot_Error.html +0 -15
  87. package/docs/class_webdriver_ActionSequence.html +0 -115
  88. package/docs/class_webdriver_Alert.html +0 -24
  89. package/docs/class_webdriver_AlertPromise.html +0 -91
  90. package/docs/class_webdriver_Capabilities.html +0 -60
  91. package/docs/class_webdriver_Command.html +0 -15
  92. package/docs/class_webdriver_EventEmitter.html +0 -35
  93. package/docs/class_webdriver_FileDetector.html +0 -21
  94. package/docs/class_webdriver_Locator.html +0 -12
  95. package/docs/class_webdriver_Serializable.html +0 -9
  96. package/docs/class_webdriver_Session.html +0 -13
  97. package/docs/class_webdriver_TouchSequence.html +0 -49
  98. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  99. package/docs/class_webdriver_WebDriver.html +0 -313
  100. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  101. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  102. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  103. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  104. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  105. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  106. package/docs/class_webdriver_WebElement.html +0 -216
  107. package/docs/class_webdriver_WebElementPromise.html +0 -266
  108. package/docs/class_webdriver_http_Executor.html +0 -22
  109. package/docs/class_webdriver_http_Request.html +0 -12
  110. package/docs/class_webdriver_http_Response.html +0 -13
  111. package/docs/class_webdriver_logging_Entry.html +0 -15
  112. package/docs/class_webdriver_logging_Level.html +0 -55
  113. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  114. package/docs/class_webdriver_logging_Logger.html +0 -119
  115. package/docs/class_webdriver_logging_Preferences.html +0 -8
  116. package/docs/class_webdriver_promise_CancellationError.html +0 -18
  117. package/docs/class_webdriver_promise_ControlFlow.html +0 -109
  118. package/docs/class_webdriver_promise_Deferred.html +0 -84
  119. package/docs/class_webdriver_promise_Promise.html +0 -74
  120. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  121. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  122. package/docs/class_webdriver_testing_Assertion.html +0 -99
  123. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  124. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  125. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  126. package/docs/class_webdriver_until_Condition.html +0 -7
  127. package/docs/dossier.css +0 -1
  128. package/docs/dossier.js +0 -86
  129. package/docs/enum_bot_ErrorCode.html +0 -3
  130. package/docs/enum_bot_Error_State.html +0 -2
  131. package/docs/enum_webdriver_Browser.html +0 -2
  132. package/docs/enum_webdriver_Button.html +0 -2
  133. package/docs/enum_webdriver_Capability.html +0 -33
  134. package/docs/enum_webdriver_CommandName.html +0 -3
  135. package/docs/enum_webdriver_Key.html +0 -12
  136. package/docs/enum_webdriver_logging_Type.html +0 -6
  137. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  138. package/docs/index.html +0 -123
  139. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  140. package/docs/interface_webdriver_http_Client.html +0 -10
  141. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  142. package/docs/module_selenium-webdriver.html +0 -23
  143. package/docs/module_selenium-webdriver__base.html +0 -23
  144. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  145. package/docs/module_selenium-webdriver_builder.html +0 -2
  146. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  147. package/docs/module_selenium-webdriver_chrome.html +0 -90
  148. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  149. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  150. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  151. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  152. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  153. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  154. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  155. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  156. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  157. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  158. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  159. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  160. package/docs/module_selenium-webdriver_class_WebElement.html +0 -216
  161. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -266
  162. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  163. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  164. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  165. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  166. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  167. package/docs/module_selenium-webdriver_error.html +0 -4
  168. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  169. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  170. package/docs/module_selenium-webdriver_executors.html +0 -10
  171. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  172. package/docs/module_selenium-webdriver_firefox.html +0 -67
  173. package/docs/module_selenium-webdriver_firefox_binary.html +0 -4
  174. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -21
  175. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -21
  176. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  177. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  178. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  180. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  181. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  182. package/docs/module_selenium-webdriver_http.html +0 -9
  183. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  184. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  185. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  186. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  187. package/docs/module_selenium-webdriver_http_util.html +0 -17
  188. package/docs/module_selenium-webdriver_ie.html +0 -11
  189. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  190. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  191. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  192. package/docs/module_selenium-webdriver_io.html +0 -37
  193. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  194. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  195. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  196. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  197. package/docs/module_selenium-webdriver_namespace_promise.html +0 -162
  198. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  199. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  200. package/docs/module_selenium-webdriver_net.html +0 -7
  201. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  202. package/docs/module_selenium-webdriver_opera.html +0 -62
  203. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  204. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  205. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  206. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  207. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  208. package/docs/module_selenium-webdriver_proxy.html +0 -28
  209. package/docs/module_selenium-webdriver_remote.html +0 -8
  210. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  211. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  212. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -40
  213. package/docs/module_selenium-webdriver_safari.html +0 -9
  214. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  215. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  216. package/docs/module_selenium-webdriver_testing.html +0 -74
  217. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  218. package/docs/namespace_bot.html +0 -4
  219. package/docs/namespace_bot_json.html +0 -20
  220. package/docs/namespace_bot_response.html +0 -18
  221. package/docs/namespace_bot_userAgent.html +0 -33
  222. package/docs/namespace_webdriver.html +0 -30
  223. package/docs/namespace_webdriver_By.html +0 -56
  224. package/docs/namespace_webdriver_http.html +0 -6
  225. package/docs/namespace_webdriver_logging.html +0 -70
  226. package/docs/namespace_webdriver_promise.html +0 -165
  227. package/docs/namespace_webdriver_stacktrace.html +0 -17
  228. package/docs/namespace_webdriver_testing.html +0 -7
  229. package/docs/namespace_webdriver_testing_assert.html +0 -9
  230. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  231. package/docs/namespace_webdriver_until.html +0 -82
  232. package/docs/source/_base.js.src.html +0 -1
  233. package/docs/source/builder.js.src.html +0 -1
  234. package/docs/source/chrome.js.src.html +0 -1
  235. package/docs/source/error.js.src.html +0 -1
  236. package/docs/source/executors.js.src.html +0 -1
  237. package/docs/source/firefox/binary.js.src.html +0 -1
  238. package/docs/source/firefox/extension.js.src.html +0 -1
  239. package/docs/source/firefox/index.js.src.html +0 -1
  240. package/docs/source/firefox/profile.js.src.html +0 -1
  241. package/docs/source/http/index.js.src.html +0 -1
  242. package/docs/source/http/util.js.src.html +0 -1
  243. package/docs/source/ie.js.src.html +0 -1
  244. package/docs/source/index.js.src.html +0 -1
  245. package/docs/source/io/exec.js.src.html +0 -1
  246. package/docs/source/io/index.js.src.html +0 -1
  247. package/docs/source/lib/atoms/error.js.src.html +0 -1
  248. package/docs/source/lib/atoms/json.js.src.html +0 -1
  249. package/docs/source/lib/atoms/response.js.src.html +0 -1
  250. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  251. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  252. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  254. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  255. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  256. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  257. package/docs/source/lib/goog/base.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  261. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  262. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  263. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  264. package/docs/source/lib/goog/deps.js.src.html +0 -1
  265. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  266. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  271. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  272. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  273. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  285. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  286. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  291. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  292. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  293. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  294. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  295. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  296. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  310. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  311. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  314. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  315. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  316. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  318. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  319. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  320. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  322. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  323. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  326. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  327. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  328. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/watchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  348. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  349. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  350. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  351. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  369. package/docs/source/net/index.js.src.html +0 -1
  370. package/docs/source/net/portprober.js.src.html +0 -1
  371. package/docs/source/opera.js.src.html +0 -1
  372. package/docs/source/phantomjs.js.src.html +0 -1
  373. package/docs/source/proxy.js.src.html +0 -1
  374. package/docs/source/remote/index.js.src.html +0 -1
  375. package/docs/source/safari.js.src.html +0 -1
  376. package/docs/source/testing/assert.js.src.html +0 -1
  377. package/docs/source/testing/index.js.src.html +0 -1
  378. package/docs/types.js +0 -1
  379. package/lib/atoms/error.js +0 -202
  380. package/lib/atoms/json.js +0 -80
  381. package/lib/atoms/response.js +0 -110
  382. package/lib/atoms/userAgent.js +0 -257
  383. package/lib/goog/LICENSE +0 -176
  384. package/lib/goog/array/array.js +0 -1655
  385. package/lib/goog/asserts/asserts.js +0 -365
  386. package/lib/goog/async/freelist.js +0 -88
  387. package/lib/goog/async/nexttick.js +0 -241
  388. package/lib/goog/async/run.js +0 -139
  389. package/lib/goog/async/workqueue.js +0 -139
  390. package/lib/goog/base.js +0 -2547
  391. package/lib/goog/debug/debug.js +0 -653
  392. package/lib/goog/debug/entrypointregistry.js +0 -158
  393. package/lib/goog/debug/error.js +0 -63
  394. package/lib/goog/debug/logbuffer.js +0 -148
  395. package/lib/goog/debug/logger.js +0 -873
  396. package/lib/goog/debug/logrecord.js +0 -242
  397. package/lib/goog/deps.js +0 -151
  398. package/lib/goog/disposable/disposable.js +0 -307
  399. package/lib/goog/disposable/idisposable.js +0 -45
  400. package/lib/goog/dom/browserfeature.js +0 -72
  401. package/lib/goog/dom/dom.js +0 -2995
  402. package/lib/goog/dom/nodetype.js +0 -48
  403. package/lib/goog/dom/safe.js +0 -347
  404. package/lib/goog/dom/tagname.js +0 -160
  405. package/lib/goog/dom/tags.js +0 -42
  406. package/lib/goog/dom/vendor.js +0 -96
  407. package/lib/goog/events/browserevent.js +0 -386
  408. package/lib/goog/events/browserfeature.js +0 -85
  409. package/lib/goog/events/event.js +0 -143
  410. package/lib/goog/events/eventid.js +0 -47
  411. package/lib/goog/events/events.js +0 -984
  412. package/lib/goog/events/eventtarget.js +0 -394
  413. package/lib/goog/events/eventtype.js +0 -233
  414. package/lib/goog/events/keycodes.js +0 -420
  415. package/lib/goog/events/listenable.js +0 -335
  416. package/lib/goog/events/listener.js +0 -131
  417. package/lib/goog/events/listenermap.js +0 -308
  418. package/lib/goog/fs/url.js +0 -105
  419. package/lib/goog/functions/functions.js +0 -332
  420. package/lib/goog/html/safehtml.js +0 -756
  421. package/lib/goog/html/safescript.js +0 -234
  422. package/lib/goog/html/safestyle.js +0 -442
  423. package/lib/goog/html/safestylesheet.js +0 -276
  424. package/lib/goog/html/safeurl.js +0 -431
  425. package/lib/goog/html/trustedresourceurl.js +0 -224
  426. package/lib/goog/html/uncheckedconversions.js +0 -231
  427. package/lib/goog/i18n/bidi.js +0 -908
  428. package/lib/goog/iter/iter.js +0 -1305
  429. package/lib/goog/json/json.js +0 -365
  430. package/lib/goog/labs/testing/assertthat.js +0 -58
  431. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  432. package/lib/goog/labs/testing/matcher.js +0 -80
  433. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  434. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  435. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  436. package/lib/goog/labs/useragent/browser.js +0 -327
  437. package/lib/goog/labs/useragent/engine.js +0 -160
  438. package/lib/goog/labs/useragent/platform.js +0 -160
  439. package/lib/goog/labs/useragent/util.js +0 -148
  440. package/lib/goog/math/box.js +0 -389
  441. package/lib/goog/math/coordinate.js +0 -268
  442. package/lib/goog/math/math.js +0 -451
  443. package/lib/goog/math/rect.js +0 -476
  444. package/lib/goog/math/size.js +0 -227
  445. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  446. package/lib/goog/net/xhrlike.js +0 -124
  447. package/lib/goog/net/xmlhttp.js +0 -246
  448. package/lib/goog/net/xmlhttpfactory.js +0 -67
  449. package/lib/goog/object/object.js +0 -686
  450. package/lib/goog/promise/promise.js +0 -1310
  451. package/lib/goog/promise/resolver.js +0 -48
  452. package/lib/goog/promise/thenable.js +0 -126
  453. package/lib/goog/reflect/reflect.js +0 -78
  454. package/lib/goog/string/const.js +0 -182
  455. package/lib/goog/string/string.js +0 -1565
  456. package/lib/goog/string/typedstring.js +0 -48
  457. package/lib/goog/structs/collection.js +0 -56
  458. package/lib/goog/structs/map.js +0 -456
  459. package/lib/goog/structs/set.js +0 -279
  460. package/lib/goog/structs/structs.js +0 -354
  461. package/lib/goog/style/style.js +0 -2054
  462. package/lib/goog/testing/asserts.js +0 -1265
  463. package/lib/goog/testing/events/events.js +0 -727
  464. package/lib/goog/testing/functionmock.js +0 -176
  465. package/lib/goog/testing/jsunit.js +0 -162
  466. package/lib/goog/testing/loosemock.js +0 -242
  467. package/lib/goog/testing/mock.js +0 -645
  468. package/lib/goog/testing/mockclock.js +0 -617
  469. package/lib/goog/testing/mockcontrol.js +0 -220
  470. package/lib/goog/testing/mockinterface.js +0 -45
  471. package/lib/goog/testing/mockmatchers.js +0 -400
  472. package/lib/goog/testing/objectpropertystring.js +0 -68
  473. package/lib/goog/testing/propertyreplacer.js +0 -245
  474. package/lib/goog/testing/recordfunction.js +0 -215
  475. package/lib/goog/testing/stacktrace.js +0 -594
  476. package/lib/goog/testing/strictmock.js +0 -130
  477. package/lib/goog/testing/testcase.js +0 -1569
  478. package/lib/goog/testing/testrunner.js +0 -440
  479. package/lib/goog/testing/watchers.js +0 -46
  480. package/lib/goog/uri/uri.js +0 -1507
  481. package/lib/goog/uri/utils.js +0 -1116
  482. package/lib/goog/useragent/product.js +0 -175
  483. package/lib/goog/useragent/product_isversion.js +0 -143
  484. package/lib/goog/useragent/useragent.js +0 -538
  485. package/lib/webdriver/actionsequence.js +0 -356
  486. package/lib/webdriver/builder.js +0 -208
  487. package/lib/webdriver/capabilities.js +0 -411
  488. package/lib/webdriver/events.js +0 -179
  489. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  490. package/lib/webdriver/http/corsclient.js +0 -133
  491. package/lib/webdriver/http/http.js +0 -523
  492. package/lib/webdriver/http/xhrclient.js +0 -67
  493. package/lib/webdriver/locators.js +0 -257
  494. package/lib/webdriver/logging.js +0 -347
  495. package/lib/webdriver/promise.js +0 -2609
  496. package/lib/webdriver/serializable.js +0 -41
  497. package/lib/webdriver/session.js +0 -74
  498. package/lib/webdriver/stacktrace.js +0 -619
  499. package/lib/webdriver/test/builder_test.js +0 -53
  500. package/lib/webdriver/test/capabilities_test.js +0 -72
  501. package/lib/webdriver/test/events_test.js +0 -203
  502. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  503. package/lib/webdriver/test/http/http_test.js +0 -428
  504. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  505. package/lib/webdriver/test/locators_test.js +0 -59
  506. package/lib/webdriver/test/logging_test.js +0 -85
  507. package/lib/webdriver/test/promise_error_test.js +0 -719
  508. package/lib/webdriver/test/promise_flow_test.js +0 -1957
  509. package/lib/webdriver/test/promise_generator_test.js +0 -251
  510. package/lib/webdriver/test/promise_test.js +0 -1981
  511. package/lib/webdriver/test/stacktrace_test.js +0 -480
  512. package/lib/webdriver/test/test_bootstrap.js +0 -67
  513. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  514. package/lib/webdriver/test/testing/client_test.js +0 -88
  515. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  516. package/lib/webdriver/test/testutil.js +0 -209
  517. package/lib/webdriver/test/testutil_test.js +0 -104
  518. package/lib/webdriver/test/until_test.js +0 -411
  519. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  520. package/lib/webdriver/test/webdriver_test.js +0 -2369
  521. package/lib/webdriver/testing/asserts.js +0 -487
  522. package/lib/webdriver/testing/client.js +0 -179
  523. package/lib/webdriver/testing/jsunit.js +0 -363
  524. package/lib/webdriver/testing/testcase.js +0 -168
  525. package/lib/webdriver/testing/window.js +0 -244
  526. package/lib/webdriver/touchsequence.js +0 -248
  527. package/lib/webdriver/until.js +0 -412
  528. package/lib/webdriver/webdriver.js +0 -2492
  529. package/test/_base_test.js +0 -129
package/docs/source/lib/goog/testing/mockmatchers.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>mockmatchers.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mockmatchers.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Matchers to be used with the mock utilities. They allow for<tr><td><a id="l17"></a><a href="#l17">17</a><td> * flexible matching by type. Custom matchers can be created by passing a<tr><td><a id="l18"></a><a href="#l18">18</a><td> * matcher function into an ArgumentMatcher instance.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * For examples, please see the unit test.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.testing.mockmatchers&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.testing.mockmatchers.ArgumentMatcher&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.testing.mockmatchers.IgnoreArgument&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.provide(&#39;goog.testing.mockmatchers.InstanceOf&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.provide(&#39;goog.testing.mockmatchers.ObjectEquals&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.provide(&#39;goog.testing.mockmatchers.RegexpMatch&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.provide(&#39;goog.testing.mockmatchers.SaveArgument&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.provide(&#39;goog.testing.mockmatchers.TypeOf&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.dom&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * A simple interface for executing argument matching. A match in this case is<tr><td><a id="l42"></a><a href="#l42">42</a><td> * testing to see if a supplied object fits a given criteria. True is returned<tr><td><a id="l43"></a><a href="#l43">43</a><td> * if the given criteria is met.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {Function=} opt_matchFn A function that evaluates a given argument<tr><td><a id="l45"></a><a href="#l45">45</a><td> * and returns true if it meets a given criteria.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @param {?string=} opt_matchName The name expressing intent as part of<tr><td><a id="l47"></a><a href="#l47">47</a><td> * an error message for when a match fails.<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @constructor<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.testing.mockmatchers.ArgumentMatcher =<tr><td><a id="l51"></a><a href="#l51">51</a><td> function(opt_matchFn, opt_matchName) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> /**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * A function that evaluates a given argument and returns true if it meets a<tr><td><a id="l54"></a><a href="#l54">54</a><td> * given criteria.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @type {Function}<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @private<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td> this.matchFn_ = opt_matchFn || null;<tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td> /**<tr><td><a id="l61"></a><a href="#l61">61</a><td> * A string indicating the match intent (e.g. isBoolean or isString).<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @type {?string}<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @private<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td> this.matchName_ = opt_matchName || null;<tr><td><a id="l66"></a><a href="#l66">66</a><td>};<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * A function that takes a match argument and an optional MockExpectation<tr><td><a id="l71"></a><a href="#l71">71</a><td> * which (if provided) will get error information and returns whether or<tr><td><a id="l72"></a><a href="#l72">72</a><td> * not it matches.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @param {*} toVerify The argument that should be verified.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {goog.testing.MockExpectation?=} opt_expectation The expectation<tr><td><a id="l75"></a><a href="#l75">75</a><td> * for this match.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {boolean} Whether or not a given argument passes verification.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.testing.mockmatchers.ArgumentMatcher.prototype.matches =<tr><td><a id="l79"></a><a href="#l79">79</a><td> function(toVerify, opt_expectation) {<tr><td><a id="l80"></a><a href="#l80">80</a><td> if (this.matchFn_) {<tr><td><a id="l81"></a><a href="#l81">81</a><td> var isamatch = this.matchFn_(toVerify);<tr><td><a id="l82"></a><a href="#l82">82</a><td> if (!isamatch &amp;&amp; opt_expectation) {<tr><td><a id="l83"></a><a href="#l83">83</a><td> if (this.matchName_) {<tr><td><a id="l84"></a><a href="#l84">84</a><td> opt_expectation.addErrorMessage(&#39;Expected: &#39; +<tr><td><a id="l85"></a><a href="#l85">85</a><td> this.matchName_ + &#39; but was: &#39; + _displayStringForValue(toVerify));<tr><td><a id="l86"></a><a href="#l86">86</a><td> } else {<tr><td><a id="l87"></a><a href="#l87">87</a><td> opt_expectation.addErrorMessage(&#39;Expected: missing mockmatcher&#39; +<tr><td><a id="l88"></a><a href="#l88">88</a><td> &#39; description but was: &#39; +<tr><td><a id="l89"></a><a href="#l89">89</a><td> _displayStringForValue(toVerify));<tr><td><a id="l90"></a><a href="#l90">90</a><td> }<tr><td><a id="l91"></a><a href="#l91">91</a><td> }<tr><td><a id="l92"></a><a href="#l92">92</a><td> return isamatch;<tr><td><a id="l93"></a><a href="#l93">93</a><td> } else {<tr><td><a id="l94"></a><a href="#l94">94</a><td> throw Error(&#39;No match function defined for this mock matcher&#39;);<tr><td><a id="l95"></a><a href="#l95">95</a><td> }<tr><td><a id="l96"></a><a href="#l96">96</a><td>};<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * A matcher that verifies that an argument is an instance of a given class.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {Function} ctor The class that will be used for verification.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @constructor<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @final<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.testing.mockmatchers.InstanceOf = function(ctor) {<tr><td><a id="l108"></a><a href="#l108">108</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l109"></a><a href="#l109">109</a><td> function(obj) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> return obj instanceof ctor;<tr><td><a id="l111"></a><a href="#l111">111</a><td> // NOTE: Browser differences on ctor.toString() output<tr><td><a id="l112"></a><a href="#l112">112</a><td> // make using that here problematic. So for now, just let<tr><td><a id="l113"></a><a href="#l113">113</a><td> // people know the instanceOf() failed without providing<tr><td><a id="l114"></a><a href="#l114">114</a><td> // browser specific details...<tr><td><a id="l115"></a><a href="#l115">115</a><td> }, &#39;instanceOf()&#39;);<tr><td><a id="l116"></a><a href="#l116">116</a><td>};<tr><td><a id="l117"></a><a href="#l117">117</a><td>goog.inherits(goog.testing.mockmatchers.InstanceOf,<tr><td><a id="l118"></a><a href="#l118">118</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>/**<tr><td><a id="l123"></a><a href="#l123">123</a><td> * A matcher that verifies that an argument is of a given type (e.g. &quot;object&quot;).<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {string} type The type that a given argument must have.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @constructor<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @final<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.testing.mockmatchers.TypeOf = function(type) {<tr><td><a id="l130"></a><a href="#l130">130</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l131"></a><a href="#l131">131</a><td> function(obj) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> return goog.typeOf(obj) == type;<tr><td><a id="l133"></a><a href="#l133">133</a><td> }, &#39;typeOf(&#39; + type + &#39;)&#39;);<tr><td><a id="l134"></a><a href="#l134">134</a><td>};<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.inherits(goog.testing.mockmatchers.TypeOf,<tr><td><a id="l136"></a><a href="#l136">136</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>/**<tr><td><a id="l141"></a><a href="#l141">141</a><td> * A matcher that verifies that an argument matches a given RegExp.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {RegExp} regexp The regular expression that the argument must match.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @constructor<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @final<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.testing.mockmatchers.RegexpMatch = function(regexp) {<tr><td><a id="l148"></a><a href="#l148">148</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l149"></a><a href="#l149">149</a><td> function(str) {<tr><td><a id="l150"></a><a href="#l150">150</a><td> return regexp.test(str);<tr><td><a id="l151"></a><a href="#l151">151</a><td> }, &#39;match(&#39; + regexp + &#39;)&#39;);<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td>goog.inherits(goog.testing.mockmatchers.RegexpMatch,<tr><td><a id="l154"></a><a href="#l154">154</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>/**<tr><td><a id="l159"></a><a href="#l159">159</a><td> * A matcher that always returns true. It is useful when the user does not care<tr><td><a id="l160"></a><a href="#l160">160</a><td> * for some arguments.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * For example: mockFunction(&#39;username&#39;, &#39;password&#39;, IgnoreArgument);<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @constructor<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @final<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.testing.mockmatchers.IgnoreArgument = function() {<tr><td><a id="l167"></a><a href="#l167">167</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l168"></a><a href="#l168">168</a><td> function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td> return true;<tr><td><a id="l170"></a><a href="#l170">170</a><td> }, &#39;true&#39;);<tr><td><a id="l171"></a><a href="#l171">171</a><td>};<tr><td><a id="l172"></a><a href="#l172">172</a><td>goog.inherits(goog.testing.mockmatchers.IgnoreArgument,<tr><td><a id="l173"></a><a href="#l173">173</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * A matcher that verifies that the argument is an object that equals the given<tr><td><a id="l179"></a><a href="#l179">179</a><td> * expected object, using a deep comparison.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {Object} expectedObject An object to match against when<tr><td><a id="l181"></a><a href="#l181">181</a><td> * verifying the argument.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @constructor<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>goog.testing.mockmatchers.ObjectEquals = function(expectedObject) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l187"></a><a href="#l187">187</a><td> function(matchObject) {<tr><td><a id="l188"></a><a href="#l188">188</a><td> assertObjectEquals(&#39;Expected equal objects&#39;, expectedObject,<tr><td><a id="l189"></a><a href="#l189">189</a><td> matchObject);<tr><td><a id="l190"></a><a href="#l190">190</a><td> return true;<tr><td><a id="l191"></a><a href="#l191">191</a><td> }, &#39;objectEquals(&#39; + expectedObject + &#39;)&#39;);<tr><td><a id="l192"></a><a href="#l192">192</a><td>};<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.inherits(goog.testing.mockmatchers.ObjectEquals,<tr><td><a id="l194"></a><a href="#l194">194</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/** @override */<tr><td><a id="l198"></a><a href="#l198">198</a><td>goog.testing.mockmatchers.ObjectEquals.prototype.matches =<tr><td><a id="l199"></a><a href="#l199">199</a><td> function(toVerify, opt_expectation) {<tr><td><a id="l200"></a><a href="#l200">200</a><td> // Override the default matches implementation to capture the exception thrown<tr><td><a id="l201"></a><a href="#l201">201</a><td> // by assertObjectEquals (if any) and add that message to the expectation.<tr><td><a id="l202"></a><a href="#l202">202</a><td> try {<tr><td><a id="l203"></a><a href="#l203">203</a><td> return goog.testing.mockmatchers.ObjectEquals.superClass_.matches.call(<tr><td><a id="l204"></a><a href="#l204">204</a><td> this, toVerify, opt_expectation);<tr><td><a id="l205"></a><a href="#l205">205</a><td> } catch (e) {<tr><td><a id="l206"></a><a href="#l206">206</a><td> if (opt_expectation) {<tr><td><a id="l207"></a><a href="#l207">207</a><td> opt_expectation.addErrorMessage(e.message);<tr><td><a id="l208"></a><a href="#l208">208</a><td> }<tr><td><a id="l209"></a><a href="#l209">209</a><td> return false;<tr><td><a id="l210"></a><a href="#l210">210</a><td> }<tr><td><a id="l211"></a><a href="#l211">211</a><td>};<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * A matcher that saves the argument that it is verifying so that your unit test<tr><td><a id="l217"></a><a href="#l217">217</a><td> * can perform extra tests with this argument later. For example, if the<tr><td><a id="l218"></a><a href="#l218">218</a><td> * argument is a callback method, the unit test can then later call this<tr><td><a id="l219"></a><a href="#l219">219</a><td> * callback to test the asynchronous portion of the call.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {goog.testing.mockmatchers.ArgumentMatcher|Function=} opt_matcher<tr><td><a id="l221"></a><a href="#l221">221</a><td> * Argument matcher or matching function that will be used to validate the<tr><td><a id="l222"></a><a href="#l222">222</a><td> * argument. By default, argument will always be valid.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {?string=} opt_matchName The name expressing intent as part of<tr><td><a id="l224"></a><a href="#l224">224</a><td> * an error message for when a match fails.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @constructor<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @final<tr><td><a id="l228"></a><a href="#l228">228</a><td> */<tr><td><a id="l229"></a><a href="#l229">229</a><td>goog.testing.mockmatchers.SaveArgument = function(opt_matcher, opt_matchName) {<tr><td><a id="l230"></a><a href="#l230">230</a><td> goog.testing.mockmatchers.ArgumentMatcher.call(<tr><td><a id="l231"></a><a href="#l231">231</a><td> this, /** @type {Function} */ (opt_matcher), opt_matchName);<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td> if (opt_matcher instanceof goog.testing.mockmatchers.ArgumentMatcher) {<tr><td><a id="l234"></a><a href="#l234">234</a><td> /**<tr><td><a id="l235"></a><a href="#l235">235</a><td> * Delegate match requests to this matcher.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @private<tr><td><a id="l238"></a><a href="#l238">238</a><td> */<tr><td><a id="l239"></a><a href="#l239">239</a><td> this.delegateMatcher_ = opt_matcher;<tr><td><a id="l240"></a><a href="#l240">240</a><td> } else if (!opt_matcher) {<tr><td><a id="l241"></a><a href="#l241">241</a><td> this.delegateMatcher_ = goog.testing.mockmatchers.ignoreArgument;<tr><td><a id="l242"></a><a href="#l242">242</a><td> }<tr><td><a id="l243"></a><a href="#l243">243</a><td>};<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.inherits(goog.testing.mockmatchers.SaveArgument,<tr><td><a id="l245"></a><a href="#l245">245</a><td> goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>/** @override */<tr><td><a id="l249"></a><a href="#l249">249</a><td>goog.testing.mockmatchers.SaveArgument.prototype.matches = function(<tr><td><a id="l250"></a><a href="#l250">250</a><td> toVerify, opt_expectation) {<tr><td><a id="l251"></a><a href="#l251">251</a><td> this.arg = toVerify;<tr><td><a id="l252"></a><a href="#l252">252</a><td> if (this.delegateMatcher_) {<tr><td><a id="l253"></a><a href="#l253">253</a><td> return this.delegateMatcher_.matches(toVerify, opt_expectation);<tr><td><a id="l254"></a><a href="#l254">254</a><td> }<tr><td><a id="l255"></a><a href="#l255">255</a><td> return goog.testing.mockmatchers.SaveArgument.superClass_.matches.call(<tr><td><a id="l256"></a><a href="#l256">256</a><td> this, toVerify, opt_expectation);<tr><td><a id="l257"></a><a href="#l257">257</a><td>};<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>/**<tr><td><a id="l261"></a><a href="#l261">261</a><td> * Saved argument that was verified.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @type {*}<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>goog.testing.mockmatchers.SaveArgument.prototype.arg;<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * An instance of the IgnoreArgument matcher. Returns true for all matches.<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @type {goog.testing.mockmatchers.IgnoreArgument}<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>goog.testing.mockmatchers.ignoreArgument =<tr><td><a id="l272"></a><a href="#l272">272</a><td> new goog.testing.mockmatchers.IgnoreArgument();<tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td><tr><td><a id="l275"></a><a href="#l275">275</a><td>/**<tr><td><a id="l276"></a><a href="#l276">276</a><td> * A matcher that verifies that an argument is an array.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.testing.mockmatchers.isArray =<tr><td><a id="l280"></a><a href="#l280">280</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isArray,<tr><td><a id="l281"></a><a href="#l281">281</a><td> &#39;isArray&#39;);<tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td>/**<tr><td><a id="l285"></a><a href="#l285">285</a><td> * A matcher that verifies that an argument is a array-like. A NodeList is an<tr><td><a id="l286"></a><a href="#l286">286</a><td> * example of a collection that is very close to an array.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>goog.testing.mockmatchers.isArrayLike =<tr><td><a id="l290"></a><a href="#l290">290</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isArrayLike,<tr><td><a id="l291"></a><a href="#l291">291</a><td> &#39;isArrayLike&#39;);<tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td>/**<tr><td><a id="l295"></a><a href="#l295">295</a><td> * A matcher that verifies that an argument is a date-like.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.testing.mockmatchers.isDateLike =<tr><td><a id="l299"></a><a href="#l299">299</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isDateLike,<tr><td><a id="l300"></a><a href="#l300">300</a><td> &#39;isDateLike&#39;);<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * A matcher that verifies that an argument is a string.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.testing.mockmatchers.isString =<tr><td><a id="l308"></a><a href="#l308">308</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isString,<tr><td><a id="l309"></a><a href="#l309">309</a><td> &#39;isString&#39;);<tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * A matcher that verifies that an argument is a boolean.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l315"></a><a href="#l315">315</a><td> */<tr><td><a id="l316"></a><a href="#l316">316</a><td>goog.testing.mockmatchers.isBoolean =<tr><td><a id="l317"></a><a href="#l317">317</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isBoolean,<tr><td><a id="l318"></a><a href="#l318">318</a><td> &#39;isBoolean&#39;);<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td>/**<tr><td><a id="l322"></a><a href="#l322">322</a><td> * A matcher that verifies that an argument is a number.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>goog.testing.mockmatchers.isNumber =<tr><td><a id="l326"></a><a href="#l326">326</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isNumber,<tr><td><a id="l327"></a><a href="#l327">327</a><td> &#39;isNumber&#39;);<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * A matcher that verifies that an argument is a function.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>goog.testing.mockmatchers.isFunction =<tr><td><a id="l335"></a><a href="#l335">335</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isFunction,<tr><td><a id="l336"></a><a href="#l336">336</a><td> &#39;isFunction&#39;);<tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td>/**<tr><td><a id="l340"></a><a href="#l340">340</a><td> * A matcher that verifies that an argument is an object.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l342"></a><a href="#l342">342</a><td> */<tr><td><a id="l343"></a><a href="#l343">343</a><td>goog.testing.mockmatchers.isObject =<tr><td><a id="l344"></a><a href="#l344">344</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.isObject,<tr><td><a id="l345"></a><a href="#l345">345</a><td> &#39;isObject&#39;);<tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td>/**<tr><td><a id="l349"></a><a href="#l349">349</a><td> * A matcher that verifies that an argument is like a DOM node.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>goog.testing.mockmatchers.isNodeLike =<tr><td><a id="l353"></a><a href="#l353">353</a><td> new goog.testing.mockmatchers.ArgumentMatcher(goog.dom.isNodeLike,<tr><td><a id="l354"></a><a href="#l354">354</a><td> &#39;isNodeLike&#39;);<tr><td><a id="l355"></a><a href="#l355">355</a><td><tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td>/**<tr><td><a id="l358"></a><a href="#l358">358</a><td> * A function that checks to see if an array matches a given set of<tr><td><a id="l359"></a><a href="#l359">359</a><td> * expectations. The expectations array can be a mix of ArgumentMatcher<tr><td><a id="l360"></a><a href="#l360">360</a><td> * implementations and values. True will be returned if values are identical or<tr><td><a id="l361"></a><a href="#l361">361</a><td> * if a matcher returns a positive result.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {Array&lt;?&gt;} expectedArr An array of expectations which can be either<tr><td><a id="l363"></a><a href="#l363">363</a><td> * values to check for equality or ArgumentMatchers.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {Array&lt;?&gt;} arr The array to match.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @param {goog.testing.MockExpectation?=} opt_expectation The expectation<tr><td><a id="l366"></a><a href="#l366">366</a><td> * for this match.<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @return {boolean} Whether or not the given array matches the expectations.<tr><td><a id="l368"></a><a href="#l368">368</a><td> */<tr><td><a id="l369"></a><a href="#l369">369</a><td>goog.testing.mockmatchers.flexibleArrayMatcher =<tr><td><a id="l370"></a><a href="#l370">370</a><td> function(expectedArr, arr, opt_expectation) {<tr><td><a id="l371"></a><a href="#l371">371</a><td> return goog.array.equals(expectedArr, arr, function(a, b) {<tr><td><a id="l372"></a><a href="#l372">372</a><td> var errCount = 0;<tr><td><a id="l373"></a><a href="#l373">373</a><td> if (opt_expectation) {<tr><td><a id="l374"></a><a href="#l374">374</a><td> errCount = opt_expectation.getErrorMessageCount();<tr><td><a id="l375"></a><a href="#l375">375</a><td> }<tr><td><a id="l376"></a><a href="#l376">376</a><td> var isamatch = a === b ||<tr><td><a id="l377"></a><a href="#l377">377</a><td> a instanceof goog.testing.mockmatchers.ArgumentMatcher &amp;&amp;<tr><td><a id="l378"></a><a href="#l378">378</a><td> a.matches(b, opt_expectation);<tr><td><a id="l379"></a><a href="#l379">379</a><td> var failureMessage = null;<tr><td><a id="l380"></a><a href="#l380">380</a><td> if (!isamatch) {<tr><td><a id="l381"></a><a href="#l381">381</a><td> failureMessage = goog.testing.asserts.findDifferences(a, b);<tr><td><a id="l382"></a><a href="#l382">382</a><td> isamatch = !failureMessage;<tr><td><a id="l383"></a><a href="#l383">383</a><td> }<tr><td><a id="l384"></a><a href="#l384">384</a><td> if (!isamatch &amp;&amp; opt_expectation) {<tr><td><a id="l385"></a><a href="#l385">385</a><td> // If the error count changed, the match sent out an error<tr><td><a id="l386"></a><a href="#l386">386</a><td> // message. If the error count has not changed, then<tr><td><a id="l387"></a><a href="#l387">387</a><td> // we need to send out an error message...<tr><td><a id="l388"></a><a href="#l388">388</a><td> if (errCount == opt_expectation.getErrorMessageCount()) {<tr><td><a id="l389"></a><a href="#l389">389</a><td> // Use the _displayStringForValue() from assert.js<tr><td><a id="l390"></a><a href="#l390">390</a><td> // for consistency...<tr><td><a id="l391"></a><a href="#l391">391</a><td> if (!failureMessage) {<tr><td><a id="l392"></a><a href="#l392">392</a><td> failureMessage = &#39;Expected: &#39; + _displayStringForValue(a) +<tr><td><a id="l393"></a><a href="#l393">393</a><td> &#39; but was: &#39; + _displayStringForValue(b);<tr><td><a id="l394"></a><a href="#l394">394</a><td> }<tr><td><a id="l395"></a><a href="#l395">395</a><td> opt_expectation.addErrorMessage(failureMessage);<tr><td><a id="l396"></a><a href="#l396">396</a><td> }<tr><td><a id="l397"></a><a href="#l397">397</a><td> }<tr><td><a id="l398"></a><a href="#l398">398</a><td> return isamatch;<tr><td><a id="l399"></a><a href="#l399">399</a><td> });<tr><td><a id="l400"></a><a href="#l400">400</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/testing/objectpropertystring.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>objectpropertystring.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/objectpropertystring.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper for passing property names as string literals in<tr><td><a id="l17"></a><a href="#l17">17</a><td> * compiled test code.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.testing.ObjectPropertyString&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Object to pass a property name as a string literal and its containing object<tr><td><a id="l27"></a><a href="#l27">27</a><td> * when the JSCompiler is rewriting these names. This should only be used in<tr><td><a id="l28"></a><a href="#l28">28</a><td> * test code.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {Object} object The containing object.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {Object|string} propertyString Property name as a string literal.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @constructor<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @final<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.testing.ObjectPropertyString = function(object, propertyString) {<tr><td><a id="l36"></a><a href="#l36">36</a><td> this.object_ = object;<tr><td><a id="l37"></a><a href="#l37">37</a><td> this.propertyString_ = /** @type {string} */ (propertyString);<tr><td><a id="l38"></a><a href="#l38">38</a><td>};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {Object}<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @private<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.testing.ObjectPropertyString.prototype.object_;<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>/**<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @type {string}<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @private<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.testing.ObjectPropertyString.prototype.propertyString_;<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @return {Object} The object.<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.testing.ObjectPropertyString.prototype.getObject = function() {<tr><td><a id="l59"></a><a href="#l59">59</a><td> return this.object_;<tr><td><a id="l60"></a><a href="#l60">60</a><td>};<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>/**<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {string} The property string.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.testing.ObjectPropertyString.prototype.getPropertyString = function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td> return this.propertyString_;<tr><td><a id="l68"></a><a href="#l68">68</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/testing/propertyreplacer.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>propertyreplacer.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/propertyreplacer.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper class for creating stubs for testing.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.PropertyReplacer&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>/** @suppress {extraRequire} Needed for some tests to compile. */<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.testing.ObjectPropertyString&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Helper class for stubbing out variables and object properties for unit tests.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * This class can change the value of some variables before running the test<tr><td><a id="l31"></a><a href="#l31">31</a><td> * cases, and to reset them in the tearDown phase.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * See googletest.StubOutForTesting as an analogy in Python:<tr><td><a id="l33"></a><a href="#l33">33</a><td> * http://protobuf.googlecode.com/svn/trunk/python/stubout.py<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Example usage:<tr><td><a id="l36"></a><a href="#l36">36</a><td> * &lt;pre&gt;var stubs = new goog.testing.PropertyReplacer();<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * function setUp() {<tr><td><a id="l39"></a><a href="#l39">39</a><td> * // Mock functions used in all test cases.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * stubs.set(Math, &#39;random&#39;, function() {<tr><td><a id="l41"></a><a href="#l41">41</a><td> * return 4; // Chosen by fair dice roll. Guaranteed to be random.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * });<tr><td><a id="l43"></a><a href="#l43">43</a><td> * }<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * function tearDown() {<tr><td><a id="l46"></a><a href="#l46">46</a><td> * stubs.reset();<tr><td><a id="l47"></a><a href="#l47">47</a><td> * }<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * function testThreeDice() {<tr><td><a id="l50"></a><a href="#l50">50</a><td> * // Mock a constant used only in this test case.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * stubs.set(goog.global, &#39;DICE_COUNT&#39;, 3);<tr><td><a id="l52"></a><a href="#l52">52</a><td> * assertEquals(12, rollAllDice());<tr><td><a id="l53"></a><a href="#l53">53</a><td> * }&lt;/pre&gt;<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Constraints on altered objects:<tr><td><a id="l56"></a><a href="#l56">56</a><td> * &lt;ul&gt;<tr><td><a id="l57"></a><a href="#l57">57</a><td> * &lt;li&gt;DOM subclasses aren&#39;t supported.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * &lt;li&gt;The value of the objects&#39; constructor property must either be equal to<tr><td><a id="l59"></a><a href="#l59">59</a><td> * the real constructor or kept untouched.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * &lt;/ul&gt;<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @constructor<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @final<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td>goog.testing.PropertyReplacer = function() {<tr><td><a id="l66"></a><a href="#l66">66</a><td> /**<tr><td><a id="l67"></a><a href="#l67">67</a><td> * Stores the values changed by the set() method in chronological order.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * Its items are objects with 3 fields: &#39;object&#39;, &#39;key&#39;, &#39;value&#39;. The<tr><td><a id="l69"></a><a href="#l69">69</a><td> * original value for the given key in the given object is stored under the<tr><td><a id="l70"></a><a href="#l70">70</a><td> * &#39;value&#39; key.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @type {Array&lt;Object&gt;}<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @private<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td> this.original_ = [];<tr><td><a id="l75"></a><a href="#l75">75</a><td>};<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>/**<tr><td><a id="l79"></a><a href="#l79">79</a><td> * Indicates that a key didn&#39;t exist before having been set by the set() method.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private @const<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.testing.PropertyReplacer.NO_SUCH_KEY_ = {};<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Tells if the given key exists in the object. Ignores inherited fields.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {Object|Function} obj The JavaScript or native object or function<tr><td><a id="l88"></a><a href="#l88">88</a><td> * whose key is to be checked.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {string} key The key to check.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {boolean} Whether the object has the key as own key.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @private<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.testing.PropertyReplacer.hasKey_ = function(obj, key) {<tr><td><a id="l94"></a><a href="#l94">94</a><td> if (!(key in obj)) {<tr><td><a id="l95"></a><a href="#l95">95</a><td> return false;<tr><td><a id="l96"></a><a href="#l96">96</a><td> }<tr><td><a id="l97"></a><a href="#l97">97</a><td> // hasOwnProperty is only reliable with JavaScript objects. It returns false<tr><td><a id="l98"></a><a href="#l98">98</a><td> // for built-in DOM attributes.<tr><td><a id="l99"></a><a href="#l99">99</a><td> if (Object.prototype.hasOwnProperty.call(obj, key)) {<tr><td><a id="l100"></a><a href="#l100">100</a><td> return true;<tr><td><a id="l101"></a><a href="#l101">101</a><td> }<tr><td><a id="l102"></a><a href="#l102">102</a><td> // In all browsers except Opera obj.constructor never equals to Object if<tr><td><a id="l103"></a><a href="#l103">103</a><td> // obj is an instance of a native class. In Opera we have to fall back on<tr><td><a id="l104"></a><a href="#l104">104</a><td> // examining obj.toString().<tr><td><a id="l105"></a><a href="#l105">105</a><td> if (obj.constructor == Object &amp;&amp;<tr><td><a id="l106"></a><a href="#l106">106</a><td> (!goog.userAgent.OPERA ||<tr><td><a id="l107"></a><a href="#l107">107</a><td> Object.prototype.toString.call(obj) == &#39;[object Object]&#39;)) {<tr><td><a id="l108"></a><a href="#l108">108</a><td> return false;<tr><td><a id="l109"></a><a href="#l109">109</a><td> }<tr><td><a id="l110"></a><a href="#l110">110</a><td> try {<tr><td><a id="l111"></a><a href="#l111">111</a><td> // Firefox hack to consider &quot;className&quot; part of the HTML elements or<tr><td><a id="l112"></a><a href="#l112">112</a><td> // &quot;body&quot; part of document. Although they are defined in the prototype of<tr><td><a id="l113"></a><a href="#l113">113</a><td> // HTMLElement or Document, accessing them this way throws an exception.<tr><td><a id="l114"></a><a href="#l114">114</a><td> // &lt;pre&gt;<tr><td><a id="l115"></a><a href="#l115">115</a><td> // var dummy = document.body.constructor.prototype.className<tr><td><a id="l116"></a><a href="#l116">116</a><td> // [Exception... &quot;Cannot modify properties of a WrappedNative&quot;]<tr><td><a id="l117"></a><a href="#l117">117</a><td> // &lt;/pre&gt;<tr><td><a id="l118"></a><a href="#l118">118</a><td> var dummy = obj.constructor.prototype[key];<tr><td><a id="l119"></a><a href="#l119">119</a><td> } catch (e) {<tr><td><a id="l120"></a><a href="#l120">120</a><td> return true;<tr><td><a id="l121"></a><a href="#l121">121</a><td> }<tr><td><a id="l122"></a><a href="#l122">122</a><td> return !(key in obj.constructor.prototype);<tr><td><a id="l123"></a><a href="#l123">123</a><td>};<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>/**<tr><td><a id="l127"></a><a href="#l127">127</a><td> * Deletes a key from an object. Sets it to undefined or empty string if the<tr><td><a id="l128"></a><a href="#l128">128</a><td> * delete failed.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {Object|Function} obj The object or function to delete a key from.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {string} key The key to delete.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @private<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.testing.PropertyReplacer.deleteKey_ = function(obj, key) {<tr><td><a id="l134"></a><a href="#l134">134</a><td> try {<tr><td><a id="l135"></a><a href="#l135">135</a><td> delete obj[key];<tr><td><a id="l136"></a><a href="#l136">136</a><td> // Delete has no effect for built-in properties of DOM nodes in FF.<tr><td><a id="l137"></a><a href="#l137">137</a><td> if (!goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l138"></a><a href="#l138">138</a><td> return;<tr><td><a id="l139"></a><a href="#l139">139</a><td> }<tr><td><a id="l140"></a><a href="#l140">140</a><td> } catch (e) {<tr><td><a id="l141"></a><a href="#l141">141</a><td> // IE throws TypeError when trying to delete properties of native objects<tr><td><a id="l142"></a><a href="#l142">142</a><td> // (e.g. DOM nodes or window), even if they have been added by JavaScript.<tr><td><a id="l143"></a><a href="#l143">143</a><td> }<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td> obj[key] = undefined;<tr><td><a id="l146"></a><a href="#l146">146</a><td> if (obj[key] == &#39;undefined&#39;) {<tr><td><a id="l147"></a><a href="#l147">147</a><td> // Some properties such as className in IE are always evaluated as string<tr><td><a id="l148"></a><a href="#l148">148</a><td> // so undefined will become &#39;undefined&#39;.<tr><td><a id="l149"></a><a href="#l149">149</a><td> obj[key] = &#39;&#39;;<tr><td><a id="l150"></a><a href="#l150">150</a><td> }<tr><td><a id="l151"></a><a href="#l151">151</a><td>};<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>/**<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Adds or changes a value in an object while saving its original state.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l157"></a><a href="#l157">157</a><td> * alter. See the constraints in the class description.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @param {string} key The key to change the value for.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @param {*} value The new value to set.<tr><td><a id="l160"></a><a href="#l160">160</a><td> */<tr><td><a id="l161"></a><a href="#l161">161</a><td>goog.testing.PropertyReplacer.prototype.set = function(obj, key, value) {<tr><td><a id="l162"></a><a href="#l162">162</a><td> var origValue = goog.testing.PropertyReplacer.hasKey_(obj, key) ? obj[key] :<tr><td><a id="l163"></a><a href="#l163">163</a><td> goog.testing.PropertyReplacer.NO_SUCH_KEY_;<tr><td><a id="l164"></a><a href="#l164">164</a><td> this.original_.push({object: obj, key: key, value: origValue});<tr><td><a id="l165"></a><a href="#l165">165</a><td> obj[key] = value;<tr><td><a id="l166"></a><a href="#l166">166</a><td>};<tr><td><a id="l167"></a><a href="#l167">167</a><td><tr><td><a id="l168"></a><a href="#l168">168</a><td><tr><td><a id="l169"></a><a href="#l169">169</a><td>/**<tr><td><a id="l170"></a><a href="#l170">170</a><td> * Changes an existing value in an object to another one of the same type while<tr><td><a id="l171"></a><a href="#l171">171</a><td> * saving its original state. The advantage of {@code replace} over {@link #set}<tr><td><a id="l172"></a><a href="#l172">172</a><td> * is that {@code replace} protects against typos and erroneously passing tests<tr><td><a id="l173"></a><a href="#l173">173</a><td> * after some members have been renamed during a refactoring.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l175"></a><a href="#l175">175</a><td> * alter. See the constraints in the class description.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {string} key The key to change the value for. It has to be present<tr><td><a id="l177"></a><a href="#l177">177</a><td> * either in {@code obj} or in its prototype chain.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @param {*} value The new value to set. It has to have the same type as the<tr><td><a id="l179"></a><a href="#l179">179</a><td> * original value. The types are compared with {@link goog.typeOf}.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @throws {Error} In case of missing key or type mismatch.<tr><td><a id="l181"></a><a href="#l181">181</a><td> */<tr><td><a id="l182"></a><a href="#l182">182</a><td>goog.testing.PropertyReplacer.prototype.replace = function(obj, key, value) {<tr><td><a id="l183"></a><a href="#l183">183</a><td> if (!(key in obj)) {<tr><td><a id="l184"></a><a href="#l184">184</a><td> throw Error(&#39;Cannot replace missing property &quot;&#39; + key + &#39;&quot; in &#39; + obj);<tr><td><a id="l185"></a><a href="#l185">185</a><td> }<tr><td><a id="l186"></a><a href="#l186">186</a><td> if (goog.typeOf(obj[key]) != goog.typeOf(value)) {<tr><td><a id="l187"></a><a href="#l187">187</a><td> throw Error(&#39;Cannot replace property &quot;&#39; + key + &#39;&quot; in &#39; + obj +<tr><td><a id="l188"></a><a href="#l188">188</a><td> &#39; with a value of different type&#39;);<tr><td><a id="l189"></a><a href="#l189">189</a><td> }<tr><td><a id="l190"></a><a href="#l190">190</a><td> this.set(obj, key, value);<tr><td><a id="l191"></a><a href="#l191">191</a><td>};<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * Builds an object structure for the provided namespace path. Doesn&#39;t<tr><td><a id="l196"></a><a href="#l196">196</a><td> * overwrite those prefixes of the path that are already objects or functions.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @param {string} path The path to create or alter, e.g. &#39;goog.ui.Menu&#39;.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @param {*} value The value to set.<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>goog.testing.PropertyReplacer.prototype.setPath = function(path, value) {<tr><td><a id="l201"></a><a href="#l201">201</a><td> var parts = path.split(&#39;.&#39;);<tr><td><a id="l202"></a><a href="#l202">202</a><td> var obj = goog.global;<tr><td><a id="l203"></a><a href="#l203">203</a><td> for (var i = 0; i &lt; parts.length - 1; i++) {<tr><td><a id="l204"></a><a href="#l204">204</a><td> var part = parts[i];<tr><td><a id="l205"></a><a href="#l205">205</a><td> if (part == &#39;prototype&#39; &amp;&amp; !obj[part]) {<tr><td><a id="l206"></a><a href="#l206">206</a><td> throw Error(&#39;Cannot set the prototype of &#39; + parts.slice(0, i).join(&#39;.&#39;));<tr><td><a id="l207"></a><a href="#l207">207</a><td> }<tr><td><a id="l208"></a><a href="#l208">208</a><td> if (!goog.isObject(obj[part]) &amp;&amp; !goog.isFunction(obj[part])) {<tr><td><a id="l209"></a><a href="#l209">209</a><td> this.set(obj, part, {});<tr><td><a id="l210"></a><a href="#l210">210</a><td> }<tr><td><a id="l211"></a><a href="#l211">211</a><td> obj = obj[part];<tr><td><a id="l212"></a><a href="#l212">212</a><td> }<tr><td><a id="l213"></a><a href="#l213">213</a><td> this.set(obj, parts[parts.length - 1], value);<tr><td><a id="l214"></a><a href="#l214">214</a><td>};<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>/**<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Deletes the key from the object while saving its original value.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l220"></a><a href="#l220">220</a><td> * alter. See the constraints in the class description.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {string} key The key to delete.<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.testing.PropertyReplacer.prototype.remove = function(obj, key) {<tr><td><a id="l224"></a><a href="#l224">224</a><td> if (goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l225"></a><a href="#l225">225</a><td> this.original_.push({object: obj, key: key, value: obj[key]});<tr><td><a id="l226"></a><a href="#l226">226</a><td> goog.testing.PropertyReplacer.deleteKey_(obj, key);<tr><td><a id="l227"></a><a href="#l227">227</a><td> }<tr><td><a id="l228"></a><a href="#l228">228</a><td>};<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Resets all changes made by goog.testing.PropertyReplacer.prototype.set.<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.testing.PropertyReplacer.prototype.reset = function() {<tr><td><a id="l235"></a><a href="#l235">235</a><td> for (var i = this.original_.length - 1; i &gt;= 0; i--) {<tr><td><a id="l236"></a><a href="#l236">236</a><td> var original = this.original_[i];<tr><td><a id="l237"></a><a href="#l237">237</a><td> if (original.value == goog.testing.PropertyReplacer.NO_SUCH_KEY_) {<tr><td><a id="l238"></a><a href="#l238">238</a><td> goog.testing.PropertyReplacer.deleteKey_(original.object, original.key);<tr><td><a id="l239"></a><a href="#l239">239</a><td> } else {<tr><td><a id="l240"></a><a href="#l240">240</a><td> original.object[original.key] = original.value;<tr><td><a id="l241"></a><a href="#l241">241</a><td> }<tr><td><a id="l242"></a><a href="#l242">242</a><td> delete this.original_[i];<tr><td><a id="l243"></a><a href="#l243">243</a><td> }<tr><td><a id="l244"></a><a href="#l244">244</a><td> this.original_.length = 0;<tr><td><a id="l245"></a><a href="#l245">245</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/testing/recordfunction.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>recordfunction.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/recordfunction.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper class for recording the calls of a function.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Example:<tr><td><a id="l19"></a><a href="#l19">19</a><td> * &lt;pre&gt;<tr><td><a id="l20"></a><a href="#l20">20</a><td> * var stubs = new goog.testing.PropertyReplacer();<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * function tearDown() {<tr><td><a id="l23"></a><a href="#l23">23</a><td> * stubs.reset();<tr><td><a id="l24"></a><a href="#l24">24</a><td> * }<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * function testShuffle() {<tr><td><a id="l27"></a><a href="#l27">27</a><td> * stubs.set(Math, &#39;random&#39;, goog.testing.recordFunction(Math.random));<tr><td><a id="l28"></a><a href="#l28">28</a><td> * var arr = shuffle([1, 2, 3, 4, 5]);<tr><td><a id="l29"></a><a href="#l29">29</a><td> * assertSameElements([1, 2, 3, 4, 5], arr);<tr><td><a id="l30"></a><a href="#l30">30</a><td> * assertEquals(4, Math.random.getCallCount());<tr><td><a id="l31"></a><a href="#l31">31</a><td> * }<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * function testOpenDialog() {<tr><td><a id="l34"></a><a href="#l34">34</a><td> * stubs.set(goog.ui, &#39;Dialog&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td> * goog.testing.recordConstructor(goog.ui.Dialog));<tr><td><a id="l36"></a><a href="#l36">36</a><td> * openConfirmDialog();<tr><td><a id="l37"></a><a href="#l37">37</a><td> * var lastDialogInstance = goog.ui.Dialog.getLastCall().getThis();<tr><td><a id="l38"></a><a href="#l38">38</a><td> * assertEquals(&#39;confirm&#39;, lastDialogInstance.getTitle());<tr><td><a id="l39"></a><a href="#l39">39</a><td> * }<tr><td><a id="l40"></a><a href="#l40">40</a><td> * &lt;/pre&gt;<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.provide(&#39;goog.testing.FunctionCall&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.provide(&#39;goog.testing.recordConstructor&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.provide(&#39;goog.testing.recordFunction&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Wraps the function into another one which calls the inner function and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * records its calls. The recorded function will have 3 static methods:<tr><td><a id="l54"></a><a href="#l54">54</a><td> * {@code getCallCount}, {@code getCalls} and {@code getLastCall} but won&#39;t<tr><td><a id="l55"></a><a href="#l55">55</a><td> * inherit the original function&#39;s prototype and static fields.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {!Function=} opt_f The function to wrap and record. Defaults to<tr><td><a id="l58"></a><a href="#l58">58</a><td> * {@link goog.nullFunction}.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @return {!Function} The wrapped function.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.testing.recordFunction = function(opt_f) {<tr><td><a id="l62"></a><a href="#l62">62</a><td> var f = opt_f || goog.nullFunction;<tr><td><a id="l63"></a><a href="#l63">63</a><td> var calls = [];<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td> function recordedFunction() {<tr><td><a id="l66"></a><a href="#l66">66</a><td> try {<tr><td><a id="l67"></a><a href="#l67">67</a><td> var ret = f.apply(this, arguments);<tr><td><a id="l68"></a><a href="#l68">68</a><td> calls.push(new goog.testing.FunctionCall(f, this, arguments, ret, null));<tr><td><a id="l69"></a><a href="#l69">69</a><td> return ret;<tr><td><a id="l70"></a><a href="#l70">70</a><td> } catch (err) {<tr><td><a id="l71"></a><a href="#l71">71</a><td> calls.push(new goog.testing.FunctionCall(f, this, arguments, undefined,<tr><td><a id="l72"></a><a href="#l72">72</a><td> err));<tr><td><a id="l73"></a><a href="#l73">73</a><td> throw err;<tr><td><a id="l74"></a><a href="#l74">74</a><td> }<tr><td><a id="l75"></a><a href="#l75">75</a><td> }<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td> /**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {number} Total number of calls.<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td> recordedFunction.getCallCount = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td> return calls.length;<tr><td><a id="l82"></a><a href="#l82">82</a><td> };<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td> /**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * Asserts that the function was called {@code expected} times.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @param {number} expected The expected number of calls.<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td> recordedFunction.assertCallCount = function(expected) {<tr><td><a id="l89"></a><a href="#l89">89</a><td> var actual = calls.length;<tr><td><a id="l90"></a><a href="#l90">90</a><td> assertEquals(<tr><td><a id="l91"></a><a href="#l91">91</a><td> &#39;Expected &#39; + expected + &#39; call(s), but was &#39; + actual + &#39;.&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td> expected, actual);<tr><td><a id="l93"></a><a href="#l93">93</a><td> };<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td> /**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @return {!Array&lt;!goog.testing.FunctionCall&gt;} All calls of the recorded<tr><td><a id="l97"></a><a href="#l97">97</a><td> * function.<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td> recordedFunction.getCalls = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td> return calls;<tr><td><a id="l101"></a><a href="#l101">101</a><td> };<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td> /**<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @return {goog.testing.FunctionCall} Last call of the recorded function or<tr><td><a id="l106"></a><a href="#l106">106</a><td> * null if it hasn&#39;t been called.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td> recordedFunction.getLastCall = function() {<tr><td><a id="l109"></a><a href="#l109">109</a><td> return calls[calls.length - 1] || null;<tr><td><a id="l110"></a><a href="#l110">110</a><td> };<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td> /**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * Returns and removes the last call of the recorded function.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {goog.testing.FunctionCall} Last call of the recorded function or<tr><td><a id="l115"></a><a href="#l115">115</a><td> * null if it hasn&#39;t been called.<tr><td><a id="l116"></a><a href="#l116">116</a><td> */<tr><td><a id="l117"></a><a href="#l117">117</a><td> recordedFunction.popLastCall = function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td> return calls.pop() || null;<tr><td><a id="l119"></a><a href="#l119">119</a><td> };<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td> /**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Resets the recorded function and removes all calls.<tr><td><a id="l123"></a><a href="#l123">123</a><td> */<tr><td><a id="l124"></a><a href="#l124">124</a><td> recordedFunction.reset = function() {<tr><td><a id="l125"></a><a href="#l125">125</a><td> calls.length = 0;<tr><td><a id="l126"></a><a href="#l126">126</a><td> };<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td> return recordedFunction;<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Same as {@link goog.testing.recordFunction} but the recorded function will<tr><td><a id="l134"></a><a href="#l134">134</a><td> * have the same prototype and static fields as the original one. It can be<tr><td><a id="l135"></a><a href="#l135">135</a><td> * used with constructors.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {!Function} ctor The function to wrap and record.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @return {!Function} The wrapped function.<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>goog.testing.recordConstructor = function(ctor) {<tr><td><a id="l141"></a><a href="#l141">141</a><td> var recordedConstructor = goog.testing.recordFunction(ctor);<tr><td><a id="l142"></a><a href="#l142">142</a><td> recordedConstructor.prototype = ctor.prototype;<tr><td><a id="l143"></a><a href="#l143">143</a><td> goog.mixin(recordedConstructor, ctor);<tr><td><a id="l144"></a><a href="#l144">144</a><td> return recordedConstructor;<tr><td><a id="l145"></a><a href="#l145">145</a><td>};<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Struct for a single function call.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {!Function} func The called function.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {!Object} thisContext {@code this} context of called function.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {!Arguments} args Arguments of the called function.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {*} ret Return value of the function or undefined in case of error.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {*} error The error thrown by the function or null if none.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @constructor<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.testing.FunctionCall = function(func, thisContext, args, ret, error) {<tr><td><a id="l159"></a><a href="#l159">159</a><td> this.function_ = func;<tr><td><a id="l160"></a><a href="#l160">160</a><td> this.thisContext_ = thisContext;<tr><td><a id="l161"></a><a href="#l161">161</a><td> this.arguments_ = Array.prototype.slice.call(args);<tr><td><a id="l162"></a><a href="#l162">162</a><td> this.returnValue_ = ret;<tr><td><a id="l163"></a><a href="#l163">163</a><td> this.error_ = error;<tr><td><a id="l164"></a><a href="#l164">164</a><td>};<tr><td><a id="l165"></a><a href="#l165">165</a><td><tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td>/**<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!Function} The called function.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.testing.FunctionCall.prototype.getFunction = function() {<tr><td><a id="l171"></a><a href="#l171">171</a><td> return this.function_;<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @return {!Object} {@code this} context of called function. It is the same as<tr><td><a id="l177"></a><a href="#l177">177</a><td> * the created object if the function is a constructor.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.testing.FunctionCall.prototype.getThis = function() {<tr><td><a id="l180"></a><a href="#l180">180</a><td> return this.thisContext_;<tr><td><a id="l181"></a><a href="#l181">181</a><td>};<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>/**<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @return {!Array&lt;?&gt;} Arguments of the called function.<tr><td><a id="l186"></a><a href="#l186">186</a><td> */<tr><td><a id="l187"></a><a href="#l187">187</a><td>goog.testing.FunctionCall.prototype.getArguments = function() {<tr><td><a id="l188"></a><a href="#l188">188</a><td> return this.arguments_;<tr><td><a id="l189"></a><a href="#l189">189</a><td>};<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Returns the nth argument of the called function.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {number} index 0-based index of the argument.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @return {*} The argument value or undefined if there is no such argument.<tr><td><a id="l196"></a><a href="#l196">196</a><td> */<tr><td><a id="l197"></a><a href="#l197">197</a><td>goog.testing.FunctionCall.prototype.getArgument = function(index) {<tr><td><a id="l198"></a><a href="#l198">198</a><td> return this.arguments_[index];<tr><td><a id="l199"></a><a href="#l199">199</a><td>};<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {*} Return value of the function or undefined in case of error.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>goog.testing.FunctionCall.prototype.getReturnValue = function() {<tr><td><a id="l206"></a><a href="#l206">206</a><td> return this.returnValue_;<tr><td><a id="l207"></a><a href="#l207">207</a><td>};<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @return {*} The error thrown by the function or null if none.<tr><td><a id="l212"></a><a href="#l212">212</a><td> */<tr><td><a id="l213"></a><a href="#l213">213</a><td>goog.testing.FunctionCall.prototype.getError = function() {<tr><td><a id="l214"></a><a href="#l214">214</a><td> return this.error_;<tr><td><a id="l215"></a><a href="#l215">215</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/goog/testing/stacktrace.js.src.html DELETED
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>stacktrace.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/stacktrace.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Tools for parsing and pretty printing error stack traces.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.stacktrace&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.testing.stacktrace.Frame&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Class representing one stack frame.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {string} context Context object, empty in case of global functions or<tr><td><a id="l28"></a><a href="#l28">28</a><td> * if the browser doesn&#39;t provide this information.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {string} name Function name, empty in case of anonymous functions.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {string} alias Alias of the function if available. For example the<tr><td><a id="l31"></a><a href="#l31">31</a><td> * function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the function is<tr><td><a id="l32"></a><a href="#l32">32</a><td> * defined as &lt;code&gt;a.b = function c() {};&lt;/code&gt;.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {string} args Arguments of the function in parentheses if available.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} path File path or URL including line number and optionally<tr><td><a id="l35"></a><a href="#l35">35</a><td> * column number separated by colons.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @final<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.testing.stacktrace.Frame = function(context, name, alias, args, path) {<tr><td><a id="l40"></a><a href="#l40">40</a><td> this.context_ = context;<tr><td><a id="l41"></a><a href="#l41">41</a><td> this.name_ = name;<tr><td><a id="l42"></a><a href="#l42">42</a><td> this.alias_ = alias;<tr><td><a id="l43"></a><a href="#l43">43</a><td> this.args_ = args;<tr><td><a id="l44"></a><a href="#l44">44</a><td> this.path_ = path;<tr><td><a id="l45"></a><a href="#l45">45</a><td>};<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>/**<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @return {string} The function name or empty string if the function is<tr><td><a id="l50"></a><a href="#l50">50</a><td> * anonymous and the object field which it&#39;s assigned to is unknown.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.testing.stacktrace.Frame.prototype.getName = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td> return this.name_;<tr><td><a id="l54"></a><a href="#l54">54</a><td>};<tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @return {boolean} Whether the stack frame contains an anonymous function.<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.testing.stacktrace.Frame.prototype.isAnonymous = function() {<tr><td><a id="l61"></a><a href="#l61">61</a><td> return !this.name_ || this.context_ == &#39;[object Object]&#39;;<tr><td><a id="l62"></a><a href="#l62">62</a><td>};<tr><td><a id="l63"></a><a href="#l63">63</a><td><tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * Brings one frame of the stack trace into a common format across browsers.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {string} Pretty printed stack frame.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.testing.stacktrace.Frame.prototype.toCanonicalString = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td> var htmlEscape = goog.testing.stacktrace.htmlEscape_;<tr><td><a id="l71"></a><a href="#l71">71</a><td> var deobfuscate = goog.testing.stacktrace.maybeDeobfuscateFunctionName_;<tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td> var canonical = [<tr><td><a id="l74"></a><a href="#l74">74</a><td> this.context_ ? htmlEscape(this.context_) + &#39;.&#39; : &#39;&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.name_ ? htmlEscape(deobfuscate(this.name_)) : &#39;anonymous&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td> htmlEscape(this.args_),<tr><td><a id="l77"></a><a href="#l77">77</a><td> this.alias_ ? &#39; [as &#39; + htmlEscape(deobfuscate(this.alias_)) + &#39;]&#39; : &#39;&#39;<tr><td><a id="l78"></a><a href="#l78">78</a><td> ];<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td> if (this.path_) {<tr><td><a id="l81"></a><a href="#l81">81</a><td> canonical.push(&#39; at &#39;);<tr><td><a id="l82"></a><a href="#l82">82</a><td> canonical.push(htmlEscape(this.path_));<tr><td><a id="l83"></a><a href="#l83">83</a><td> }<tr><td><a id="l84"></a><a href="#l84">84</a><td> return canonical.join(&#39;&#39;);<tr><td><a id="l85"></a><a href="#l85">85</a><td>};<tr><td><a id="l86"></a><a href="#l86">86</a><td><tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td>/**<tr><td><a id="l89"></a><a href="#l89">89</a><td> * Maximum number of steps while the call chain is followed.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @private {number}<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @const<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.testing.stacktrace.MAX_DEPTH_ = 20;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Maximum length of a string that can be matched with a RegExp on<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Firefox 3x. Exceeding this approximate length will cause string.match<tr><td><a id="l99"></a><a href="#l99">99</a><td> * to exceed Firefox&#39;s stack quota. This situation can be encountered<tr><td><a id="l100"></a><a href="#l100">100</a><td> * when goog.globalEval is invoked with a long argument; such as<tr><td><a id="l101"></a><a href="#l101">101</a><td> * when loading a module.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @private {number}<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @const<tr><td><a id="l104"></a><a href="#l104">104</a><td> */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>/**<tr><td><a id="l109"></a><a href="#l109">109</a><td> * RegExp pattern for JavaScript identifiers. We don&#39;t support Unicode<tr><td><a id="l110"></a><a href="#l110">110</a><td> * identifiers defined in ECMAScript v3.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @private {string}<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @const<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.testing.stacktrace.IDENTIFIER_PATTERN_ = &#39;[a-zA-Z_$][\\w$]*&#39;;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>/**<tr><td><a id="l118"></a><a href="#l118">118</a><td> * RegExp pattern for function name alias in the V8 stack trace.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @private {string}<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @const<tr><td><a id="l121"></a><a href="#l121">121</a><td> */<tr><td><a id="l122"></a><a href="#l122">122</a><td>goog.testing.stacktrace.V8_ALIAS_PATTERN_ =<tr><td><a id="l123"></a><a href="#l123">123</a><td> &#39;(?: \\[as (&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)\\])?&#39;;<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>/**<tr><td><a id="l127"></a><a href="#l127">127</a><td> * RegExp pattern for the context of a function call in a V8 stack trace.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * Creates an optional submatch for the namespace identifier including the<tr><td><a id="l129"></a><a href="#l129">129</a><td> * &quot;new&quot; keyword for constructor calls (e.g. &quot;new foo.Bar&quot;).<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @private {string}<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @const<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.testing.stacktrace.V8_CONTEXT_PATTERN_ =<tr><td><a id="l134"></a><a href="#l134">134</a><td> &#39;(?:((?:new )?(?:\\[object Object\\]|&#39; +<tr><td><a id="l135"></a><a href="#l135">135</a><td> goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l136"></a><a href="#l136">136</a><td> &#39;(?:\\.&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*))\\.)?&#39;;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * RegExp pattern for function names and constructor calls in the V8 stack<tr><td><a id="l141"></a><a href="#l141">141</a><td> * trace.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @private {string}<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @const<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l146"></a><a href="#l146">146</a><td> &#39;(?:new )?(?:&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l147"></a><a href="#l147">147</a><td> &#39;|&lt;anonymous&gt;)&#39;;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * RegExp pattern for function call in the V8 stack trace. Creates 3 submatches<tr><td><a id="l152"></a><a href="#l152">152</a><td> * with context object (optional), function name and function alias (optional).<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @private {string}<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @const<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l157"></a><a href="#l157">157</a><td> &#39; &#39; + goog.testing.stacktrace.V8_CONTEXT_PATTERN_ +<tr><td><a id="l158"></a><a href="#l158">158</a><td> &#39;(&#39; + goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ + &#39;)&#39; +<tr><td><a id="l159"></a><a href="#l159">159</a><td> goog.testing.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * RegExp pattern for an URL + position inside the file.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @private {string}<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @const<tr><td><a id="l166"></a><a href="#l166">166</a><td> */<tr><td><a id="l167"></a><a href="#l167">167</a><td>goog.testing.stacktrace.URL_PATTERN_ =<tr><td><a id="l168"></a><a href="#l168">168</a><td> &#39;((?:http|https|file)://[^\\s)]+|javascript:.*)&#39;;<tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td>/**<tr><td><a id="l172"></a><a href="#l172">172</a><td> * RegExp pattern for an URL + line number + column number in V8.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * The URL is either in submatch 1 or submatch 2.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @private {string}<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @const<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.testing.stacktrace.CHROME_URL_PATTERN_ = &#39; (?:&#39; +<tr><td><a id="l178"></a><a href="#l178">178</a><td> &#39;\\(unknown source\\)&#39; + &#39;|&#39; +<tr><td><a id="l179"></a><a href="#l179">179</a><td> &#39;\\(native\\)&#39; + &#39;|&#39; +<tr><td><a id="l180"></a><a href="#l180">180</a><td> &#39;\\((.+)\\)|(.+))&#39;;<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Regular expression for parsing one stack frame in V8. For more information<tr><td><a id="l185"></a><a href="#l185">185</a><td> * on V8 stack frame formats, see<tr><td><a id="l186"></a><a href="#l186">186</a><td> * https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @private {!RegExp}<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @const<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp(&#39;^ at&#39; +<tr><td><a id="l191"></a><a href="#l191">191</a><td> &#39;(?:&#39; + goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l192"></a><a href="#l192">192</a><td> goog.testing.stacktrace.CHROME_URL_PATTERN_ + &#39;$&#39;);<tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * RegExp pattern for function call in the Firefox stack trace.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Creates 2 submatches with function name (optional) and arguments.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @private {string}<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @const<tr><td><a id="l200"></a><a href="#l200">200</a><td> */<tr><td><a id="l201"></a><a href="#l201">201</a><td>goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l202"></a><a href="#l202">202</a><td> &#39;(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l203"></a><a href="#l203">203</a><td> &#39;(\\(.*\\))?@&#39;;<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Regular expression for parsing one stack frame in Firefox.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @private {!RegExp}<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @const<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l212"></a><a href="#l212">212</a><td> goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l213"></a><a href="#l213">213</a><td> &#39;(?::0|&#39; + goog.testing.stacktrace.URL_PATTERN_ + &#39;)$&#39;);<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td>/**<tr><td><a id="l217"></a><a href="#l217">217</a><td> * RegExp pattern for an anonymous function call in an Opera stack frame.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Creates 2 (optional) submatches: the context object and function name.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @private {string}<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @const<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l223"></a><a href="#l223">223</a><td> &#39;&lt;anonymous function(?:\\: &#39; +<tr><td><a id="l224"></a><a href="#l224">224</a><td> &#39;(?:(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l225"></a><a href="#l225">225</a><td> &#39;(?:\\.&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.)?&#39; +<tr><td><a id="l226"></a><a href="#l226">226</a><td> &#39;(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;))?&gt;&#39;;<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * RegExp pattern for a function call in an Opera stack frame.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Creates 4 (optional) submatches: the function name (if not anonymous),<tr><td><a id="l232"></a><a href="#l232">232</a><td> * the aliased context object and function name (if anonymous), and the<tr><td><a id="l233"></a><a href="#l233">233</a><td> * function call arguments.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @private {string}<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @const<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l238"></a><a href="#l238">238</a><td> &#39;(?:(?:(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)|&#39; +<tr><td><a id="l239"></a><a href="#l239">239</a><td> goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ +<tr><td><a id="l240"></a><a href="#l240">240</a><td> &#39;)(\\(.*\\)))?@&#39;;<tr><td><a id="l241"></a><a href="#l241">241</a><td><tr><td><a id="l242"></a><a href="#l242">242</a><td><tr><td><a id="l243"></a><a href="#l243">243</a><td>/**<tr><td><a id="l244"></a><a href="#l244">244</a><td> * Regular expression for parsing on stack frame in Opera 11.68 - 12.17.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * Newer versions of Opera use V8 and stack frames should match against<tr><td><a id="l246"></a><a href="#l246">246</a><td> * goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @private {!RegExp}<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @const<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td>goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l251"></a><a href="#l251">251</a><td> goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l252"></a><a href="#l252">252</a><td> goog.testing.stacktrace.URL_PATTERN_ + &#39;?$&#39;);<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Regular expression for finding the function name in its source.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @private {!RegExp}<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @const<tr><td><a id="l259"></a><a href="#l259">259</a><td> */<tr><td><a id="l260"></a><a href="#l260">260</a><td>goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_ = new RegExp(<tr><td><a id="l261"></a><a href="#l261">261</a><td> &#39;^function (&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)&#39;);<tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td><tr><td><a id="l264"></a><a href="#l264">264</a><td>/**<tr><td><a id="l265"></a><a href="#l265">265</a><td> * RegExp pattern for function call in a IE stack trace. This expression allows<tr><td><a id="l266"></a><a href="#l266">266</a><td> * for identifiers like &#39;Anonymous function&#39;, &#39;eval code&#39;, and &#39;Global code&#39;.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @private {string}<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @const<tr><td><a id="l269"></a><a href="#l269">269</a><td> */<tr><td><a id="l270"></a><a href="#l270">270</a><td>goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ = &#39;(&#39; +<tr><td><a id="l271"></a><a href="#l271">271</a><td> goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;(?:\\s+\\w+)*)&#39;;<tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td>/**<tr><td><a id="l275"></a><a href="#l275">275</a><td> * Regular expression for parsing a stack frame in IE.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @private {!RegExp}<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @const<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_ = new RegExp(&#39;^ at &#39; +<tr><td><a id="l280"></a><a href="#l280">280</a><td> goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l281"></a><a href="#l281">281</a><td> &#39;\\s*\\((eval code:[^)]*|&#39; + goog.testing.stacktrace.URL_PATTERN_ +<tr><td><a id="l282"></a><a href="#l282">282</a><td> &#39;)\\)?$&#39;);<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Creates a stack trace by following the call chain. Based on<tr><td><a id="l287"></a><a href="#l287">287</a><td> * {@link goog.debug.getStacktrace}.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {!Array&lt;!goog.testing.stacktrace.Frame&gt;} Stack frames.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @private<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @suppress {es5Strict}<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>goog.testing.stacktrace.followCallChain_ = function() {<tr><td><a id="l293"></a><a href="#l293">293</a><td> var frames = [];<tr><td><a id="l294"></a><a href="#l294">294</a><td> var fn = arguments.callee.caller;<tr><td><a id="l295"></a><a href="#l295">295</a><td> var depth = 0;<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td> while (fn &amp;&amp; depth &lt; goog.testing.stacktrace.MAX_DEPTH_) {<tr><td><a id="l298"></a><a href="#l298">298</a><td> var fnString = Function.prototype.toString.call(fn);<tr><td><a id="l299"></a><a href="#l299">299</a><td> var match = fnString.match(goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_);<tr><td><a id="l300"></a><a href="#l300">300</a><td> var functionName = match ? match[1] : &#39;&#39;;<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td> var argsBuilder = [&#39;(&#39;];<tr><td><a id="l303"></a><a href="#l303">303</a><td> if (fn.arguments) {<tr><td><a id="l304"></a><a href="#l304">304</a><td> for (var i = 0; i &lt; fn.arguments.length; i++) {<tr><td><a id="l305"></a><a href="#l305">305</a><td> var arg = fn.arguments[i];<tr><td><a id="l306"></a><a href="#l306">306</a><td> if (i &gt; 0) {<tr><td><a id="l307"></a><a href="#l307">307</a><td> argsBuilder.push(&#39;, &#39;);<tr><td><a id="l308"></a><a href="#l308">308</a><td> }<tr><td><a id="l309"></a><a href="#l309">309</a><td> if (goog.isString(arg)) {<tr><td><a id="l310"></a><a href="#l310">310</a><td> argsBuilder.push(&#39;&quot;&#39;, arg, &#39;&quot;&#39;);<tr><td><a id="l311"></a><a href="#l311">311</a><td> } else {<tr><td><a id="l312"></a><a href="#l312">312</a><td> // Some args are mocks, and we don&#39;t want to fail from them not having<tr><td><a id="l313"></a><a href="#l313">313</a><td> // expected a call to toString, so instead insert a static string.<tr><td><a id="l314"></a><a href="#l314">314</a><td> if (arg &amp;&amp; arg[&#39;$replay&#39;]) {<tr><td><a id="l315"></a><a href="#l315">315</a><td> argsBuilder.push(&#39;goog.testing.Mock&#39;);<tr><td><a id="l316"></a><a href="#l316">316</a><td> } else {<tr><td><a id="l317"></a><a href="#l317">317</a><td> argsBuilder.push(String(arg));<tr><td><a id="l318"></a><a href="#l318">318</a><td> }<tr><td><a id="l319"></a><a href="#l319">319</a><td> }<tr><td><a id="l320"></a><a href="#l320">320</a><td> }<tr><td><a id="l321"></a><a href="#l321">321</a><td> } else {<tr><td><a id="l322"></a><a href="#l322">322</a><td> // Opera 10 doesn&#39;t know the arguments of native functions.<tr><td><a id="l323"></a><a href="#l323">323</a><td> argsBuilder.push(&#39;unknown&#39;);<tr><td><a id="l324"></a><a href="#l324">324</a><td> }<tr><td><a id="l325"></a><a href="#l325">325</a><td> argsBuilder.push(&#39;)&#39;);<tr><td><a id="l326"></a><a href="#l326">326</a><td> var args = argsBuilder.join(&#39;&#39;);<tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td> frames.push(new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, args,<tr><td><a id="l329"></a><a href="#l329">329</a><td> &#39;&#39;));<tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td> /** @preserveTry */<tr><td><a id="l332"></a><a href="#l332">332</a><td> try {<tr><td><a id="l333"></a><a href="#l333">333</a><td> fn = fn.caller;<tr><td><a id="l334"></a><a href="#l334">334</a><td> } catch (e) {<tr><td><a id="l335"></a><a href="#l335">335</a><td> break;<tr><td><a id="l336"></a><a href="#l336">336</a><td> }<tr><td><a id="l337"></a><a href="#l337">337</a><td> depth++;<tr><td><a id="l338"></a><a href="#l338">338</a><td> }<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td> return frames;<tr><td><a id="l341"></a><a href="#l341">341</a><td>};<tr><td><a id="l342"></a><a href="#l342">342</a><td><tr><td><a id="l343"></a><a href="#l343">343</a><td><tr><td><a id="l344"></a><a href="#l344">344</a><td>/**<tr><td><a id="l345"></a><a href="#l345">345</a><td> * Parses one stack frame.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @return {goog.testing.stacktrace.Frame} Stack frame object or null if the<tr><td><a id="l348"></a><a href="#l348">348</a><td> * parsing failed.<tr><td><a id="l349"></a><a href="#l349">349</a><td> * @private<tr><td><a id="l350"></a><a href="#l350">350</a><td> */<tr><td><a id="l351"></a><a href="#l351">351</a><td>goog.testing.stacktrace.parseStackFrame_ = function(frameStr) {<tr><td><a id="l352"></a><a href="#l352">352</a><td> // This match includes newer versions of Opera (15+).<tr><td><a id="l353"></a><a href="#l353">353</a><td> var m = frameStr.match(goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_);<tr><td><a id="l354"></a><a href="#l354">354</a><td> if (m) {<tr><td><a id="l355"></a><a href="#l355">355</a><td> return new goog.testing.stacktrace.Frame(m[1] || &#39;&#39;, m[2] || &#39;&#39;, m[3] || &#39;&#39;,<tr><td><a id="l356"></a><a href="#l356">356</a><td> &#39;&#39;, m[4] || m[5] || m[6] || &#39;&#39;);<tr><td><a id="l357"></a><a href="#l357">357</a><td> }<tr><td><a id="l358"></a><a href="#l358">358</a><td><tr><td><a id="l359"></a><a href="#l359">359</a><td> if (frameStr.length &gt;<tr><td><a id="l360"></a><a href="#l360">360</a><td> goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {<tr><td><a id="l361"></a><a href="#l361">361</a><td> return goog.testing.stacktrace.parseLongFirefoxFrame_(frameStr);<tr><td><a id="l362"></a><a href="#l362">362</a><td> }<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td> m = frameStr.match(goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);<tr><td><a id="l365"></a><a href="#l365">365</a><td> if (m) {<tr><td><a id="l366"></a><a href="#l366">366</a><td> return new goog.testing.stacktrace.Frame(&#39;&#39;, m[1] || &#39;&#39;, &#39;&#39;, m[2] || &#39;&#39;,<tr><td><a id="l367"></a><a href="#l367">367</a><td> m[3] || &#39;&#39;);<tr><td><a id="l368"></a><a href="#l368">368</a><td> }<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td> // Match against Presto Opera 11.68 - 12.17.<tr><td><a id="l371"></a><a href="#l371">371</a><td> m = frameStr.match(goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_);<tr><td><a id="l372"></a><a href="#l372">372</a><td> if (m) {<tr><td><a id="l373"></a><a href="#l373">373</a><td> return new goog.testing.stacktrace.Frame(m[2] || &#39;&#39;, m[1] || m[3] || &#39;&#39;,<tr><td><a id="l374"></a><a href="#l374">374</a><td> &#39;&#39;, m[4] || &#39;&#39;, m[5] || &#39;&#39;);<tr><td><a id="l375"></a><a href="#l375">375</a><td> }<tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td> m = frameStr.match(goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_);<tr><td><a id="l378"></a><a href="#l378">378</a><td> if (m) {<tr><td><a id="l379"></a><a href="#l379">379</a><td> return new goog.testing.stacktrace.Frame(&#39;&#39;, m[1] || &#39;&#39;, &#39;&#39;, &#39;&#39;,<tr><td><a id="l380"></a><a href="#l380">380</a><td> m[2] || &#39;&#39;);<tr><td><a id="l381"></a><a href="#l381">381</a><td> }<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td> return null;<tr><td><a id="l384"></a><a href="#l384">384</a><td>};<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>/**<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Parses a long firefox stack frame.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l390"></a><a href="#l390">390</a><td> * @return {!goog.testing.stacktrace.Frame} Stack frame object.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @private<tr><td><a id="l392"></a><a href="#l392">392</a><td> */<tr><td><a id="l393"></a><a href="#l393">393</a><td>goog.testing.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {<tr><td><a id="l394"></a><a href="#l394">394</a><td> var firstParen = frameStr.indexOf(&#39;(&#39;);<tr><td><a id="l395"></a><a href="#l395">395</a><td> var lastAmpersand = frameStr.lastIndexOf(&#39;@&#39;);<tr><td><a id="l396"></a><a href="#l396">396</a><td> var lastColon = frameStr.lastIndexOf(&#39;:&#39;);<tr><td><a id="l397"></a><a href="#l397">397</a><td> var functionName = &#39;&#39;;<tr><td><a id="l398"></a><a href="#l398">398</a><td> if ((firstParen &gt;= 0) &amp;&amp; (firstParen &lt; lastAmpersand)) {<tr><td><a id="l399"></a><a href="#l399">399</a><td> functionName = frameStr.substring(0, firstParen);<tr><td><a id="l400"></a><a href="#l400">400</a><td> }<tr><td><a id="l401"></a><a href="#l401">401</a><td> var loc = &#39;&#39;;<tr><td><a id="l402"></a><a href="#l402">402</a><td> if ((lastAmpersand &gt;= 0) &amp;&amp; (lastAmpersand + 1 &lt; lastColon)) {<tr><td><a id="l403"></a><a href="#l403">403</a><td> loc = frameStr.substring(lastAmpersand + 1);<tr><td><a id="l404"></a><a href="#l404">404</a><td> }<tr><td><a id="l405"></a><a href="#l405">405</a><td> var args = &#39;&#39;;<tr><td><a id="l406"></a><a href="#l406">406</a><td> if ((firstParen &gt;= 0 &amp;&amp; lastAmpersand &gt; 0) &amp;&amp;<tr><td><a id="l407"></a><a href="#l407">407</a><td> (firstParen &lt; lastAmpersand)) {<tr><td><a id="l408"></a><a href="#l408">408</a><td> args = frameStr.substring(firstParen, lastAmpersand);<tr><td><a id="l409"></a><a href="#l409">409</a><td> }<tr><td><a id="l410"></a><a href="#l410">410</a><td> return new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, args, loc);<tr><td><a id="l411"></a><a href="#l411">411</a><td>};<tr><td><a id="l412"></a><a href="#l412">412</a><td><tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td>/**<tr><td><a id="l415"></a><a href="#l415">415</a><td> * Function to deobfuscate function names.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @type {function(string): string}<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @private<tr><td><a id="l418"></a><a href="#l418">418</a><td> */<tr><td><a id="l419"></a><a href="#l419">419</a><td>goog.testing.stacktrace.deobfuscateFunctionName_;<tr><td><a id="l420"></a><a href="#l420">420</a><td><tr><td><a id="l421"></a><a href="#l421">421</a><td><tr><td><a id="l422"></a><a href="#l422">422</a><td>/**<tr><td><a id="l423"></a><a href="#l423">423</a><td> * Sets function to deobfuscate function names.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @param {function(string): string} fn function to deobfuscate function names.<tr><td><a id="l425"></a><a href="#l425">425</a><td> */<tr><td><a id="l426"></a><a href="#l426">426</a><td>goog.testing.stacktrace.setDeobfuscateFunctionName = function(fn) {<tr><td><a id="l427"></a><a href="#l427">427</a><td> goog.testing.stacktrace.deobfuscateFunctionName_ = fn;<tr><td><a id="l428"></a><a href="#l428">428</a><td>};<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Deobfuscates a compiled function name with the function passed to<tr><td><a id="l433"></a><a href="#l433">433</a><td> * {@link #setDeobfuscateFunctionName}. Returns the original function name if<tr><td><a id="l434"></a><a href="#l434">434</a><td> * the deobfuscator hasn&#39;t been set.<tr><td><a id="l435"></a><a href="#l435">435</a><td> * @param {string} name The function name to deobfuscate.<tr><td><a id="l436"></a><a href="#l436">436</a><td> * @return {string} The deobfuscated function name.<tr><td><a id="l437"></a><a href="#l437">437</a><td> * @private<tr><td><a id="l438"></a><a href="#l438">438</a><td> */<tr><td><a id="l439"></a><a href="#l439">439</a><td>goog.testing.stacktrace.maybeDeobfuscateFunctionName_ = function(name) {<tr><td><a id="l440"></a><a href="#l440">440</a><td> return goog.testing.stacktrace.deobfuscateFunctionName_ ?<tr><td><a id="l441"></a><a href="#l441">441</a><td> goog.testing.stacktrace.deobfuscateFunctionName_(name) : name;<tr><td><a id="l442"></a><a href="#l442">442</a><td>};<tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td><tr><td><a id="l445"></a><a href="#l445">445</a><td>/**<tr><td><a id="l446"></a><a href="#l446">446</a><td> * Escapes the special character in HTML.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {string} text Plain text.<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @return {string} Escaped text.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @private<tr><td><a id="l450"></a><a href="#l450">450</a><td> */<tr><td><a id="l451"></a><a href="#l451">451</a><td>goog.testing.stacktrace.htmlEscape_ = function(text) {<tr><td><a id="l452"></a><a href="#l452">452</a><td> return text.replace(/&amp;/g, &#39;&amp;amp;&#39;).<tr><td><a id="l453"></a><a href="#l453">453</a><td> replace(/&lt;/g, &#39;&amp;lt;&#39;).<tr><td><a id="l454"></a><a href="#l454">454</a><td> replace(/&gt;/g, &#39;&amp;gt;&#39;).<tr><td><a id="l455"></a><a href="#l455">455</a><td> replace(/&quot;/g, &#39;&amp;quot;&#39;);<tr><td><a id="l456"></a><a href="#l456">456</a><td>};<tr><td><a id="l457"></a><a href="#l457">457</a><td><tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td>/**<tr><td><a id="l460"></a><a href="#l460">460</a><td> * Converts the stack frames into canonical format. Chops the beginning and the<tr><td><a id="l461"></a><a href="#l461">461</a><td> * end of it which come from the testing environment, not from the test itself.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @param {!Array&lt;goog.testing.stacktrace.Frame&gt;} frames The frames.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @return {string} Canonical, pretty printed stack trace.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @private<tr><td><a id="l465"></a><a href="#l465">465</a><td> */<tr><td><a id="l466"></a><a href="#l466">466</a><td>goog.testing.stacktrace.framesToString_ = function(frames) {<tr><td><a id="l467"></a><a href="#l467">467</a><td> // Removes the anonymous calls from the end of the stack trace (they come<tr><td><a id="l468"></a><a href="#l468">468</a><td> // from testrunner.js, testcase.js and asserts.js), so the stack trace will<tr><td><a id="l469"></a><a href="#l469">469</a><td> // end with the test... method.<tr><td><a id="l470"></a><a href="#l470">470</a><td> var lastIndex = frames.length - 1;<tr><td><a id="l471"></a><a href="#l471">471</a><td> while (frames[lastIndex] &amp;&amp; frames[lastIndex].isAnonymous()) {<tr><td><a id="l472"></a><a href="#l472">472</a><td> lastIndex--;<tr><td><a id="l473"></a><a href="#l473">473</a><td> }<tr><td><a id="l474"></a><a href="#l474">474</a><td><tr><td><a id="l475"></a><a href="#l475">475</a><td> // Removes the beginning of the stack trace until the call of the private<tr><td><a id="l476"></a><a href="#l476">476</a><td> // _assert function (inclusive), so the stack trace will begin with a public<tr><td><a id="l477"></a><a href="#l477">477</a><td> // asserter. Does nothing if _assert is not present in the stack trace.<tr><td><a id="l478"></a><a href="#l478">478</a><td> var privateAssertIndex = -1;<tr><td><a id="l479"></a><a href="#l479">479</a><td> for (var i = 0; i &lt; frames.length; i++) {<tr><td><a id="l480"></a><a href="#l480">480</a><td> if (frames[i] &amp;&amp; frames[i].getName() == &#39;_assert&#39;) {<tr><td><a id="l481"></a><a href="#l481">481</a><td> privateAssertIndex = i;<tr><td><a id="l482"></a><a href="#l482">482</a><td> break;<tr><td><a id="l483"></a><a href="#l483">483</a><td> }<tr><td><a id="l484"></a><a href="#l484">484</a><td> }<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td> var canonical = [];<tr><td><a id="l487"></a><a href="#l487">487</a><td> for (var i = privateAssertIndex + 1; i &lt;= lastIndex; i++) {<tr><td><a id="l488"></a><a href="#l488">488</a><td> canonical.push(&#39;&gt; &#39;);<tr><td><a id="l489"></a><a href="#l489">489</a><td> if (frames[i]) {<tr><td><a id="l490"></a><a href="#l490">490</a><td> canonical.push(frames[i].toCanonicalString());<tr><td><a id="l491"></a><a href="#l491">491</a><td> } else {<tr><td><a id="l492"></a><a href="#l492">492</a><td> canonical.push(&#39;(unknown)&#39;);<tr><td><a id="l493"></a><a href="#l493">493</a><td> }<tr><td><a id="l494"></a><a href="#l494">494</a><td> canonical.push(&#39;\n&#39;);<tr><td><a id="l495"></a><a href="#l495">495</a><td> }<tr><td><a id="l496"></a><a href="#l496">496</a><td> return canonical.join(&#39;&#39;);<tr><td><a id="l497"></a><a href="#l497">497</a><td>};<tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td><tr><td><a id="l500"></a><a href="#l500">500</a><td>/**<tr><td><a id="l501"></a><a href="#l501">501</a><td> * Parses the browser&#39;s native stack trace.<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @param {string} stack Stack trace.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @return {!Array&lt;goog.testing.stacktrace.Frame&gt;} Stack frames. The<tr><td><a id="l504"></a><a href="#l504">504</a><td> * unrecognized frames will be nulled out.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * @private<tr><td><a id="l506"></a><a href="#l506">506</a><td> */<tr><td><a id="l507"></a><a href="#l507">507</a><td>goog.testing.stacktrace.parse_ = function(stack) {<tr><td><a id="l508"></a><a href="#l508">508</a><td> var lines = stack.replace(/\s*$/, &#39;&#39;).split(&#39;\n&#39;);<tr><td><a id="l509"></a><a href="#l509">509</a><td> var frames = [];<tr><td><a id="l510"></a><a href="#l510">510</a><td> for (var i = 0; i &lt; lines.length; i++) {<tr><td><a id="l511"></a><a href="#l511">511</a><td> frames.push(goog.testing.stacktrace.parseStackFrame_(lines[i]));<tr><td><a id="l512"></a><a href="#l512">512</a><td> }<tr><td><a id="l513"></a><a href="#l513">513</a><td> return frames;<tr><td><a id="l514"></a><a href="#l514">514</a><td>};<tr><td><a id="l515"></a><a href="#l515">515</a><td><tr><td><a id="l516"></a><a href="#l516">516</a><td><tr><td><a id="l517"></a><a href="#l517">517</a><td>/**<tr><td><a id="l518"></a><a href="#l518">518</a><td> * Brings the stack trace into a common format across browsers.<tr><td><a id="l519"></a><a href="#l519">519</a><td> * @param {string} stack Browser-specific stack trace.<tr><td><a id="l520"></a><a href="#l520">520</a><td> * @return {string} Same stack trace in common format.<tr><td><a id="l521"></a><a href="#l521">521</a><td> */<tr><td><a id="l522"></a><a href="#l522">522</a><td>goog.testing.stacktrace.canonicalize = function(stack) {<tr><td><a id="l523"></a><a href="#l523">523</a><td> var frames = goog.testing.stacktrace.parse_(stack);<tr><td><a id="l524"></a><a href="#l524">524</a><td> return goog.testing.stacktrace.framesToString_(frames);<tr><td><a id="l525"></a><a href="#l525">525</a><td>};<tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td>/**<tr><td><a id="l529"></a><a href="#l529">529</a><td> * Returns the native stack trace.<tr><td><a id="l530"></a><a href="#l530">530</a><td> * @return {string|!Array&lt;!CallSite&gt;}<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @private<tr><td><a id="l532"></a><a href="#l532">532</a><td> */<tr><td><a id="l533"></a><a href="#l533">533</a><td>goog.testing.stacktrace.getNativeStack_ = function() {<tr><td><a id="l534"></a><a href="#l534">534</a><td> var tmpError = new Error();<tr><td><a id="l535"></a><a href="#l535">535</a><td> if (tmpError.stack) {<tr><td><a id="l536"></a><a href="#l536">536</a><td> return tmpError.stack;<tr><td><a id="l537"></a><a href="#l537">537</a><td> }<tr><td><a id="l538"></a><a href="#l538">538</a><td><tr><td><a id="l539"></a><a href="#l539">539</a><td> // IE10 will only create a stack trace when the Error is thrown.<tr><td><a id="l540"></a><a href="#l540">540</a><td> // We use null.x() to throw an exception because the closure compiler may<tr><td><a id="l541"></a><a href="#l541">541</a><td> // replace &quot;throw&quot; with a function call in an attempt to minimize the binary<tr><td><a id="l542"></a><a href="#l542">542</a><td> // size, which in turn has the side effect of adding an unwanted stack frame.<tr><td><a id="l543"></a><a href="#l543">543</a><td> try {<tr><td><a id="l544"></a><a href="#l544">544</a><td> null.x();<tr><td><a id="l545"></a><a href="#l545">545</a><td> } catch (e) {<tr><td><a id="l546"></a><a href="#l546">546</a><td> return e.stack;<tr><td><a id="l547"></a><a href="#l547">547</a><td> }<tr><td><a id="l548"></a><a href="#l548">548</a><td> return &#39;&#39;;<tr><td><a id="l549"></a><a href="#l549">549</a><td>};<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td>/**<tr><td><a id="l553"></a><a href="#l553">553</a><td> * Gets the native stack trace if available otherwise follows the call chain.<tr><td><a id="l554"></a><a href="#l554">554</a><td> * @return {string} The stack trace in canonical format.<tr><td><a id="l555"></a><a href="#l555">555</a><td> */<tr><td><a id="l556"></a><a href="#l556">556</a><td>goog.testing.stacktrace.get = function() {<tr><td><a id="l557"></a><a href="#l557">557</a><td> var stack = goog.testing.stacktrace.getNativeStack_();<tr><td><a id="l558"></a><a href="#l558">558</a><td> var frames;<tr><td><a id="l559"></a><a href="#l559">559</a><td> if (!stack) {<tr><td><a id="l560"></a><a href="#l560">560</a><td> frames = goog.testing.stacktrace.followCallChain_();<tr><td><a id="l561"></a><a href="#l561">561</a><td> } else if (goog.isArray(stack)) {<tr><td><a id="l562"></a><a href="#l562">562</a><td> frames = goog.testing.stacktrace.callSitesToFrames_(stack);<tr><td><a id="l563"></a><a href="#l563">563</a><td> } else {<tr><td><a id="l564"></a><a href="#l564">564</a><td> frames = goog.testing.stacktrace.parse_(stack);<tr><td><a id="l565"></a><a href="#l565">565</a><td> }<tr><td><a id="l566"></a><a href="#l566">566</a><td> return goog.testing.stacktrace.framesToString_(frames);<tr><td><a id="l567"></a><a href="#l567">567</a><td>};<tr><td><a id="l568"></a><a href="#l568">568</a><td><tr><td><a id="l569"></a><a href="#l569">569</a><td><tr><td><a id="l570"></a><a href="#l570">570</a><td>/**<tr><td><a id="l571"></a><a href="#l571">571</a><td> * Converts an array of CallSite (elements of a stack trace in V8) to an array<tr><td><a id="l572"></a><a href="#l572">572</a><td> * of Frames.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @param {!Array&lt;!CallSite&gt;} stack The stack as an array of CallSites.<tr><td><a id="l574"></a><a href="#l574">574</a><td> * @return {!Array&lt;!goog.testing.stacktrace.Frame&gt;} The stack as an array of<tr><td><a id="l575"></a><a href="#l575">575</a><td> * Frames.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @private<tr><td><a id="l577"></a><a href="#l577">577</a><td> */<tr><td><a id="l578"></a><a href="#l578">578</a><td>goog.testing.stacktrace.callSitesToFrames_ = function(stack) {<tr><td><a id="l579"></a><a href="#l579">579</a><td> var frames = [];<tr><td><a id="l580"></a><a href="#l580">580</a><td> for (var i = 0; i &lt; stack.length; i++) {<tr><td><a id="l581"></a><a href="#l581">581</a><td> var callSite = stack[i];<tr><td><a id="l582"></a><a href="#l582">582</a><td> var functionName = callSite.getFunctionName() || &#39;unknown&#39;;<tr><td><a id="l583"></a><a href="#l583">583</a><td> var fileName = callSite.getFileName();<tr><td><a id="l584"></a><a href="#l584">584</a><td> var path = fileName ? fileName + &#39;:&#39; + callSite.getLineNumber() + &#39;:&#39; +<tr><td><a id="l585"></a><a href="#l585">585</a><td> callSite.getColumnNumber() : &#39;unknown&#39;;<tr><td><a id="l586"></a><a href="#l586">586</a><td> frames.push(<tr><td><a id="l587"></a><a href="#l587">587</a><td> new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, &#39;&#39;, path));<tr><td><a id="l588"></a><a href="#l588">588</a><td> }<tr><td><a id="l589"></a><a href="#l589">589</a><td> return frames;<tr><td><a id="l590"></a><a href="#l590">590</a><td>};<tr><td><a id="l591"></a><a href="#l591">591</a><td><tr><td><a id="l592"></a><a href="#l592">592</a><td><tr><td><a id="l593"></a><a href="#l593">593</a><td>goog.exportSymbol(&#39;setDeobfuscateFunctionName&#39;,<tr><td><a id="l594"></a><a href="#l594">594</a><td> goog.testing.stacktrace.setDeobfuscateFunctionName);</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>