selenium-webdriver 2.48.2 → 2.53.3

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 (534) hide show
  1. package/CHANGES.md +116 -0
  2. package/NOTICE +1 -1
  3. package/README.md +59 -9
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +9 -6
  8. package/example/google_search.js +1 -1
  9. package/example/google_search_generator.js +2 -4
  10. package/example/logging.js +6 -2
  11. package/example/sample.js +21 -0
  12. package/executors.js +11 -27
  13. package/firefox/binary.js +149 -98
  14. package/firefox/extension.js +15 -19
  15. package/firefox/index.js +256 -163
  16. package/firefox/profile.js +223 -243
  17. package/http/index.js +487 -81
  18. package/http/util.js +40 -36
  19. package/ie.js +288 -309
  20. package/index.js +34 -125
  21. package/io/exec.js +58 -39
  22. package/io/index.js +72 -60
  23. package/lib/README +4 -0
  24. package/lib/actions.js +596 -0
  25. package/lib/by.js +277 -0
  26. package/lib/capabilities.js +450 -0
  27. package/lib/{webdriver/command.js → command.js} +91 -72
  28. package/lib/{webdriver/button.js → devmode.js} +13 -8
  29. package/lib/error.js +690 -0
  30. package/lib/events.js +212 -0
  31. package/lib/firefox/amd64/libnoblur64.so +0 -0
  32. package/lib/firefox/i386/libnoblur.so +0 -0
  33. package/lib/firefox/webdriver.json +5 -1
  34. package/lib/firefox/webdriver.xpi +0 -0
  35. package/lib/{webdriver/key.js → input.js} +84 -2
  36. package/lib/logging.js +670 -0
  37. package/lib/{webdriver/promise.js → promise.js} +817 -644
  38. package/lib/safari/client.js +266 -214
  39. package/lib/session.js +80 -0
  40. package/lib/{webdriver/serializable.js → symbols.js} +16 -19
  41. package/lib/test/build.js +4 -4
  42. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  43. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  44. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  45. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  46. package/lib/test/data/hidden_partially.html +45 -0
  47. package/lib/test/data/readOnlyPage.html +1 -1
  48. package/lib/test/data/selectPage.html +18 -2
  49. package/lib/test/fileserver.js +3 -4
  50. package/lib/test/index.js +7 -3
  51. package/lib/test/resources.js +1 -1
  52. package/lib/until.js +376 -0
  53. package/lib/webdriver.js +2440 -0
  54. package/net/index.js +4 -0
  55. package/net/portprober.js +16 -12
  56. package/opera.js +295 -314
  57. package/package.json +6 -5
  58. package/phantomjs.js +144 -147
  59. package/proxy.js +10 -6
  60. package/remote/index.js +289 -238
  61. package/safari.js +326 -311
  62. package/test/chrome/options_test.js +11 -9
  63. package/test/element_finding_test.js +51 -13
  64. package/test/execute_script_test.js +17 -3
  65. package/test/firefox/firefox_test.js +0 -32
  66. package/test/http/http_test.js +671 -61
  67. package/test/http/util_test.js +25 -23
  68. package/test/io_test.js +67 -1
  69. package/test/lib/by_test.js +139 -0
  70. package/test/lib/capabilities_test.js +111 -0
  71. package/test/lib/error_test.js +325 -0
  72. package/test/lib/events_test.js +177 -0
  73. package/test/lib/logging_test.js +272 -0
  74. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  75. package/test/lib/promise_error_test.js +808 -0
  76. package/test/lib/promise_flow_test.js +2282 -0
  77. package/test/lib/promise_generator_test.js +308 -0
  78. package/test/lib/promise_test.js +996 -0
  79. package/test/lib/testutil.js +90 -0
  80. package/test/lib/until_test.js +400 -0
  81. package/test/lib/webdriver_test.js +2157 -0
  82. package/test/page_loading_test.js +7 -9
  83. package/test/remote_test.js +50 -3
  84. package/test/session_test.js +53 -0
  85. package/test/stale_element_test.js +2 -2
  86. package/test/testing/assert_test.js +374 -0
  87. package/test/testing/index_test.js +9 -11
  88. package/testing/assert.js +334 -17
  89. package/testing/index.js +12 -2
  90. package/_base.js +0 -200
  91. package/docs/Changes.html +0 -356
  92. package/docs/class_bot_Error.html +0 -15
  93. package/docs/class_webdriver_ActionSequence.html +0 -115
  94. package/docs/class_webdriver_Alert.html +0 -24
  95. package/docs/class_webdriver_AlertPromise.html +0 -92
  96. package/docs/class_webdriver_Capabilities.html +0 -60
  97. package/docs/class_webdriver_Command.html +0 -15
  98. package/docs/class_webdriver_EventEmitter.html +0 -35
  99. package/docs/class_webdriver_FileDetector.html +0 -21
  100. package/docs/class_webdriver_Locator.html +0 -12
  101. package/docs/class_webdriver_Serializable.html +0 -9
  102. package/docs/class_webdriver_Session.html +0 -13
  103. package/docs/class_webdriver_TouchSequence.html +0 -49
  104. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  105. package/docs/class_webdriver_WebDriver.html +0 -313
  106. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  107. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  108. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  109. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  110. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  111. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  112. package/docs/class_webdriver_WebElement.html +0 -223
  113. package/docs/class_webdriver_WebElementPromise.html +0 -274
  114. package/docs/class_webdriver_http_Executor.html +0 -22
  115. package/docs/class_webdriver_http_Request.html +0 -12
  116. package/docs/class_webdriver_http_Response.html +0 -13
  117. package/docs/class_webdriver_logging_Entry.html +0 -15
  118. package/docs/class_webdriver_logging_Level.html +0 -55
  119. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  120. package/docs/class_webdriver_logging_Logger.html +0 -119
  121. package/docs/class_webdriver_logging_Preferences.html +0 -8
  122. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  123. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  124. package/docs/class_webdriver_promise_Deferred.html +0 -84
  125. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  126. package/docs/class_webdriver_promise_Promise.html +0 -75
  127. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  128. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  129. package/docs/class_webdriver_testing_Assertion.html +0 -99
  130. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  131. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  132. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  133. package/docs/class_webdriver_until_Condition.html +0 -7
  134. package/docs/dossier.css +0 -1
  135. package/docs/dossier.js +0 -86
  136. package/docs/enum_bot_ErrorCode.html +0 -3
  137. package/docs/enum_bot_Error_State.html +0 -2
  138. package/docs/enum_webdriver_Browser.html +0 -2
  139. package/docs/enum_webdriver_Button.html +0 -2
  140. package/docs/enum_webdriver_Capability.html +0 -33
  141. package/docs/enum_webdriver_CommandName.html +0 -3
  142. package/docs/enum_webdriver_Key.html +0 -12
  143. package/docs/enum_webdriver_logging_Type.html +0 -6
  144. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  145. package/docs/index.html +0 -125
  146. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  147. package/docs/interface_webdriver_http_Client.html +0 -10
  148. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  149. package/docs/module_selenium-webdriver.html +0 -23
  150. package/docs/module_selenium-webdriver__base.html +0 -23
  151. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  152. package/docs/module_selenium-webdriver_builder.html +0 -2
  153. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  154. package/docs/module_selenium-webdriver_chrome.html +0 -90
  155. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  156. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  157. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  158. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  159. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  160. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  161. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  162. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  163. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  164. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  165. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  166. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  167. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  168. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  169. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  170. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  171. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  172. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  173. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  174. package/docs/module_selenium-webdriver_error.html +0 -4
  175. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  176. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  177. package/docs/module_selenium-webdriver_executors.html +0 -10
  178. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  179. package/docs/module_selenium-webdriver_firefox.html +0 -68
  180. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  181. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  182. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  183. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  184. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  185. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  186. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  187. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  188. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  189. package/docs/module_selenium-webdriver_http.html +0 -9
  190. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  191. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  192. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  193. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  194. package/docs/module_selenium-webdriver_http_util.html +0 -17
  195. package/docs/module_selenium-webdriver_ie.html +0 -11
  196. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  197. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  198. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  199. package/docs/module_selenium-webdriver_io.html +0 -37
  200. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  201. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  202. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  203. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  204. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  205. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  206. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  207. package/docs/module_selenium-webdriver_net.html +0 -7
  208. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  209. package/docs/module_selenium-webdriver_opera.html +0 -62
  210. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  211. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  212. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  213. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  214. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  215. package/docs/module_selenium-webdriver_proxy.html +0 -28
  216. package/docs/module_selenium-webdriver_remote.html +0 -8
  217. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  218. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  219. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  220. package/docs/module_selenium-webdriver_safari.html +0 -9
  221. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  222. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  223. package/docs/module_selenium-webdriver_testing.html +0 -74
  224. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  225. package/docs/namespace_bot.html +0 -4
  226. package/docs/namespace_bot_json.html +0 -20
  227. package/docs/namespace_bot_response.html +0 -18
  228. package/docs/namespace_bot_userAgent.html +0 -33
  229. package/docs/namespace_webdriver.html +0 -30
  230. package/docs/namespace_webdriver_By.html +0 -56
  231. package/docs/namespace_webdriver_http.html +0 -6
  232. package/docs/namespace_webdriver_logging.html +0 -70
  233. package/docs/namespace_webdriver_promise.html +0 -688
  234. package/docs/namespace_webdriver_stacktrace.html +0 -17
  235. package/docs/namespace_webdriver_testing.html +0 -7
  236. package/docs/namespace_webdriver_testing_assert.html +0 -9
  237. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  238. package/docs/namespace_webdriver_until.html +0 -82
  239. package/docs/source/_base.js.src.html +0 -1
  240. package/docs/source/builder.js.src.html +0 -1
  241. package/docs/source/chrome.js.src.html +0 -1
  242. package/docs/source/error.js.src.html +0 -1
  243. package/docs/source/executors.js.src.html +0 -1
  244. package/docs/source/firefox/binary.js.src.html +0 -1
  245. package/docs/source/firefox/extension.js.src.html +0 -1
  246. package/docs/source/firefox/index.js.src.html +0 -1
  247. package/docs/source/firefox/profile.js.src.html +0 -1
  248. package/docs/source/http/index.js.src.html +0 -1
  249. package/docs/source/http/util.js.src.html +0 -1
  250. package/docs/source/ie.js.src.html +0 -1
  251. package/docs/source/index.js.src.html +0 -1
  252. package/docs/source/io/exec.js.src.html +0 -1
  253. package/docs/source/io/index.js.src.html +0 -1
  254. package/docs/source/lib/atoms/error.js.src.html +0 -1
  255. package/docs/source/lib/atoms/json.js.src.html +0 -1
  256. package/docs/source/lib/atoms/response.js.src.html +0 -1
  257. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  258. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  259. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  260. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  261. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  262. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  263. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  264. package/docs/source/lib/goog/base.js.src.html +0 -1
  265. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  266. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  267. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  268. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  269. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  270. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  271. package/docs/source/lib/goog/deps.js.src.html +0 -1
  272. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  273. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  274. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  275. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  276. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  277. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  278. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  279. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  280. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  285. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  286. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  287. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  288. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  289. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  290. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  291. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  292. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  293. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  294. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  295. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  296. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  297. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  298. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  299. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  300. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  301. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  302. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  303. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  307. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  308. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  309. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  310. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  311. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  312. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  313. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  314. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  315. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  316. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  317. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  318. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  319. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  320. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  321. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  322. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  323. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  324. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  325. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  326. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  327. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  328. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  329. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  330. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  331. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  332. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  333. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  334. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  335. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  336. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  348. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  349. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  350. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  351. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  352. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  353. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  354. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  355. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  356. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  357. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  358. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  369. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  370. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  371. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  372. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  373. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  374. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  375. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  376. package/docs/source/net/index.js.src.html +0 -1
  377. package/docs/source/net/portprober.js.src.html +0 -1
  378. package/docs/source/opera.js.src.html +0 -1
  379. package/docs/source/phantomjs.js.src.html +0 -1
  380. package/docs/source/proxy.js.src.html +0 -1
  381. package/docs/source/remote/index.js.src.html +0 -1
  382. package/docs/source/safari.js.src.html +0 -1
  383. package/docs/source/testing/assert.js.src.html +0 -1
  384. package/docs/source/testing/index.js.src.html +0 -1
  385. package/docs/types.js +0 -1
  386. package/lib/atoms/error.js +0 -202
  387. package/lib/atoms/json.js +0 -80
  388. package/lib/atoms/response.js +0 -110
  389. package/lib/atoms/userAgent.js +0 -257
  390. package/lib/goog/LICENSE +0 -176
  391. package/lib/goog/array/array.js +0 -1654
  392. package/lib/goog/asserts/asserts.js +0 -365
  393. package/lib/goog/async/freelist.js +0 -88
  394. package/lib/goog/async/nexttick.js +0 -241
  395. package/lib/goog/async/run.js +0 -133
  396. package/lib/goog/async/workqueue.js +0 -139
  397. package/lib/goog/base.js +0 -2548
  398. package/lib/goog/debug/debug.js +0 -653
  399. package/lib/goog/debug/entrypointregistry.js +0 -158
  400. package/lib/goog/debug/error.js +0 -63
  401. package/lib/goog/debug/logbuffer.js +0 -148
  402. package/lib/goog/debug/logger.js +0 -873
  403. package/lib/goog/debug/logrecord.js +0 -242
  404. package/lib/goog/deps.js +0 -151
  405. package/lib/goog/disposable/disposable.js +0 -307
  406. package/lib/goog/disposable/idisposable.js +0 -45
  407. package/lib/goog/dom/browserfeature.js +0 -72
  408. package/lib/goog/dom/dom.js +0 -2991
  409. package/lib/goog/dom/nodetype.js +0 -48
  410. package/lib/goog/dom/safe.js +0 -347
  411. package/lib/goog/dom/tagname.js +0 -160
  412. package/lib/goog/dom/tags.js +0 -41
  413. package/lib/goog/dom/vendor.js +0 -96
  414. package/lib/goog/events/browserevent.js +0 -400
  415. package/lib/goog/events/browserfeature.js +0 -85
  416. package/lib/goog/events/event.js +0 -143
  417. package/lib/goog/events/eventid.js +0 -47
  418. package/lib/goog/events/events.js +0 -984
  419. package/lib/goog/events/eventtarget.js +0 -394
  420. package/lib/goog/events/eventtype.js +0 -237
  421. package/lib/goog/events/keycodes.js +0 -427
  422. package/lib/goog/events/listenable.js +0 -335
  423. package/lib/goog/events/listener.js +0 -131
  424. package/lib/goog/events/listenermap.js +0 -308
  425. package/lib/goog/fs/url.js +0 -109
  426. package/lib/goog/functions/functions.js +0 -442
  427. package/lib/goog/html/safehtml.js +0 -757
  428. package/lib/goog/html/safescript.js +0 -234
  429. package/lib/goog/html/safestyle.js +0 -442
  430. package/lib/goog/html/safestylesheet.js +0 -276
  431. package/lib/goog/html/safeurl.js +0 -398
  432. package/lib/goog/html/trustedresourceurl.js +0 -224
  433. package/lib/goog/html/uncheckedconversions.js +0 -232
  434. package/lib/goog/i18n/bidi.js +0 -908
  435. package/lib/goog/iter/iter.js +0 -1302
  436. package/lib/goog/json/json.js +0 -363
  437. package/lib/goog/labs/testing/assertthat.js +0 -58
  438. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  439. package/lib/goog/labs/testing/matcher.js +0 -80
  440. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  441. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  442. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  443. package/lib/goog/labs/useragent/browser.js +0 -341
  444. package/lib/goog/labs/useragent/engine.js +0 -160
  445. package/lib/goog/labs/useragent/platform.js +0 -160
  446. package/lib/goog/labs/useragent/util.js +0 -148
  447. package/lib/goog/log/log.js +0 -197
  448. package/lib/goog/math/box.js +0 -398
  449. package/lib/goog/math/coordinate.js +0 -268
  450. package/lib/goog/math/math.js +0 -451
  451. package/lib/goog/math/rect.js +0 -476
  452. package/lib/goog/math/size.js +0 -227
  453. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  454. package/lib/goog/net/xhrlike.js +0 -124
  455. package/lib/goog/net/xmlhttp.js +0 -246
  456. package/lib/goog/net/xmlhttpfactory.js +0 -67
  457. package/lib/goog/object/object.js +0 -686
  458. package/lib/goog/promise/promise.js +0 -1350
  459. package/lib/goog/promise/resolver.js +0 -48
  460. package/lib/goog/promise/thenable.js +0 -126
  461. package/lib/goog/reflect/reflect.js +0 -77
  462. package/lib/goog/string/const.js +0 -182
  463. package/lib/goog/string/string.js +0 -1599
  464. package/lib/goog/string/typedstring.js +0 -48
  465. package/lib/goog/structs/collection.js +0 -56
  466. package/lib/goog/structs/map.js +0 -457
  467. package/lib/goog/structs/set.js +0 -279
  468. package/lib/goog/structs/structs.js +0 -354
  469. package/lib/goog/style/style.js +0 -2037
  470. package/lib/goog/testing/asserts.js +0 -1278
  471. package/lib/goog/testing/events/events.js +0 -767
  472. package/lib/goog/testing/functionmock.js +0 -175
  473. package/lib/goog/testing/jsunit.js +0 -162
  474. package/lib/goog/testing/loosemock.js +0 -242
  475. package/lib/goog/testing/mock.js +0 -645
  476. package/lib/goog/testing/mockclock.js +0 -606
  477. package/lib/goog/testing/mockcontrol.js +0 -220
  478. package/lib/goog/testing/mockinterface.js +0 -45
  479. package/lib/goog/testing/mockmatchers.js +0 -400
  480. package/lib/goog/testing/objectpropertystring.js +0 -68
  481. package/lib/goog/testing/propertyreplacer.js +0 -262
  482. package/lib/goog/testing/recordfunction.js +0 -215
  483. package/lib/goog/testing/stacktrace.js +0 -594
  484. package/lib/goog/testing/strictmock.js +0 -130
  485. package/lib/goog/testing/testcase.js +0 -1629
  486. package/lib/goog/testing/testrunner.js +0 -440
  487. package/lib/goog/uri/uri.js +0 -1524
  488. package/lib/goog/uri/utils.js +0 -1064
  489. package/lib/goog/useragent/product.js +0 -183
  490. package/lib/goog/useragent/product_isversion.js +0 -144
  491. package/lib/goog/useragent/useragent.js +0 -572
  492. package/lib/webdriver/actionsequence.js +0 -356
  493. package/lib/webdriver/builder.js +0 -207
  494. package/lib/webdriver/capabilities.js +0 -412
  495. package/lib/webdriver/events.js +0 -179
  496. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  497. package/lib/webdriver/http/corsclient.js +0 -133
  498. package/lib/webdriver/http/http.js +0 -525
  499. package/lib/webdriver/http/xhrclient.js +0 -67
  500. package/lib/webdriver/locators.js +0 -257
  501. package/lib/webdriver/logging.js +0 -347
  502. package/lib/webdriver/session.js +0 -74
  503. package/lib/webdriver/stacktrace.js +0 -619
  504. package/lib/webdriver/test/builder_test.js +0 -53
  505. package/lib/webdriver/test/capabilities_test.js +0 -72
  506. package/lib/webdriver/test/events_test.js +0 -203
  507. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  508. package/lib/webdriver/test/http/http_test.js +0 -428
  509. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  510. package/lib/webdriver/test/locators_test.js +0 -59
  511. package/lib/webdriver/test/logging_test.js +0 -85
  512. package/lib/webdriver/test/promise_error_test.js +0 -892
  513. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  514. package/lib/webdriver/test/promise_generator_test.js +0 -323
  515. package/lib/webdriver/test/promise_test.js +0 -2012
  516. package/lib/webdriver/test/stacktrace_test.js +0 -480
  517. package/lib/webdriver/test/test_bootstrap.js +0 -67
  518. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  519. package/lib/webdriver/test/testing/client_test.js +0 -88
  520. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  521. package/lib/webdriver/test/testutil.js +0 -209
  522. package/lib/webdriver/test/testutil_test.js +0 -104
  523. package/lib/webdriver/test/until_test.js +0 -411
  524. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  525. package/lib/webdriver/test/webdriver_test.js +0 -2369
  526. package/lib/webdriver/testing/asserts.js +0 -487
  527. package/lib/webdriver/testing/client.js +0 -179
  528. package/lib/webdriver/testing/jsunit.js +0 -363
  529. package/lib/webdriver/testing/testcase.js +0 -168
  530. package/lib/webdriver/testing/window.js +0 -244
  531. package/lib/webdriver/touchsequence.js +0 -248
  532. package/lib/webdriver/until.js +0 -412
  533. package/lib/webdriver/webdriver.js +0 -2511
  534. 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> *<tr><td><a id="l37"></a><a href="#l37">37</a><td> * var stubs = new goog.testing.PropertyReplacer();<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * function setUp() {<tr><td><a id="l40"></a><a href="#l40">40</a><td> * // Mock functions used in all test cases.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * stubs.set(Math, &#39;random&#39;, function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td> * return 4; // Chosen by fair dice roll. Guaranteed to be random.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * });<tr><td><a id="l44"></a><a href="#l44">44</a><td> * }<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> * function tearDown() {<tr><td><a id="l47"></a><a href="#l47">47</a><td> * stubs.reset();<tr><td><a id="l48"></a><a href="#l48">48</a><td> * }<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * function testThreeDice() {<tr><td><a id="l51"></a><a href="#l51">51</a><td> * // Mock a constant used only in this test case.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * stubs.set(goog.global, &#39;DICE_COUNT&#39;, 3);<tr><td><a id="l53"></a><a href="#l53">53</a><td> * assertEquals(12, rollAllDice());<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> * Constraints on altered objects:<tr><td><a id="l57"></a><a href="#l57">57</a><td> * &lt;ul&gt;<tr><td><a id="l58"></a><a href="#l58">58</a><td> * &lt;li&gt;DOM subclasses aren&#39;t supported.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * &lt;li&gt;The value of the objects&#39; constructor property must either be equal to<tr><td><a id="l60"></a><a href="#l60">60</a><td> * the real constructor or kept untouched.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * &lt;/ul&gt;<tr><td><a id="l62"></a><a href="#l62">62</a><td> *<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @constructor<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @final<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.PropertyReplacer = function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td> /**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * Stores the values changed by the set() method in chronological order.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * Its items are objects with 3 fields: &#39;object&#39;, &#39;key&#39;, &#39;value&#39;. The<tr><td><a id="l70"></a><a href="#l70">70</a><td> * original value for the given key in the given object is stored under the<tr><td><a id="l71"></a><a href="#l71">71</a><td> * &#39;value&#39; key.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @type {Array&lt;{ object: ?, key: string, value: ? }&gt;}<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @private<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td> this.original_ = [];<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>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * Indicates that a key didn&#39;t exist before having been set by the set() method.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @private @const<tr><td><a id="l82"></a><a href="#l82">82</a><td> */<tr><td><a id="l83"></a><a href="#l83">83</a><td>goog.testing.PropertyReplacer.NO_SUCH_KEY_ = {};<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>/**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Tells if the given key exists in the object. Ignores inherited fields.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {Object|Function} obj The JavaScript or native object or function<tr><td><a id="l89"></a><a href="#l89">89</a><td> * whose key is to be checked.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @param {string} key The key to check.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {boolean} Whether the object has the key as own key.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @private<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>goog.testing.PropertyReplacer.hasKey_ = function(obj, key) {<tr><td><a id="l95"></a><a href="#l95">95</a><td> if (!(key in obj)) {<tr><td><a id="l96"></a><a href="#l96">96</a><td> return false;<tr><td><a id="l97"></a><a href="#l97">97</a><td> }<tr><td><a id="l98"></a><a href="#l98">98</a><td> // hasOwnProperty is only reliable with JavaScript objects. It returns false<tr><td><a id="l99"></a><a href="#l99">99</a><td> // for built-in DOM attributes.<tr><td><a id="l100"></a><a href="#l100">100</a><td> if (Object.prototype.hasOwnProperty.call(obj, key)) {<tr><td><a id="l101"></a><a href="#l101">101</a><td> return true;<tr><td><a id="l102"></a><a href="#l102">102</a><td> }<tr><td><a id="l103"></a><a href="#l103">103</a><td> // In all browsers except Opera obj.constructor never equals to Object if<tr><td><a id="l104"></a><a href="#l104">104</a><td> // obj is an instance of a native class. In Opera we have to fall back on<tr><td><a id="l105"></a><a href="#l105">105</a><td> // examining obj.toString().<tr><td><a id="l106"></a><a href="#l106">106</a><td> if (obj.constructor == Object &amp;&amp;<tr><td><a id="l107"></a><a href="#l107">107</a><td> (!goog.userAgent.OPERA ||<tr><td><a id="l108"></a><a href="#l108">108</a><td> Object.prototype.toString.call(obj) == &#39;[object Object]&#39;)) {<tr><td><a id="l109"></a><a href="#l109">109</a><td> return false;<tr><td><a id="l110"></a><a href="#l110">110</a><td> }<tr><td><a id="l111"></a><a href="#l111">111</a><td> try {<tr><td><a id="l112"></a><a href="#l112">112</a><td> // Firefox hack to consider &quot;className&quot; part of the HTML elements or<tr><td><a id="l113"></a><a href="#l113">113</a><td> // &quot;body&quot; part of document. Although they are defined in the prototype of<tr><td><a id="l114"></a><a href="#l114">114</a><td> // HTMLElement or Document, accessing them this way throws an exception.<tr><td><a id="l115"></a><a href="#l115">115</a><td> // &lt;pre&gt;<tr><td><a id="l116"></a><a href="#l116">116</a><td> // var dummy = document.body.constructor.prototype.className<tr><td><a id="l117"></a><a href="#l117">117</a><td> // [Exception... &quot;Cannot modify properties of a WrappedNative&quot;]<tr><td><a id="l118"></a><a href="#l118">118</a><td> // &lt;/pre&gt;<tr><td><a id="l119"></a><a href="#l119">119</a><td> var dummy = obj.constructor.prototype[key];<tr><td><a id="l120"></a><a href="#l120">120</a><td> } catch (e) {<tr><td><a id="l121"></a><a href="#l121">121</a><td> return true;<tr><td><a id="l122"></a><a href="#l122">122</a><td> }<tr><td><a id="l123"></a><a href="#l123">123</a><td> return !(key in obj.constructor.prototype);<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>/**<tr><td><a id="l128"></a><a href="#l128">128</a><td> * Deletes a key from an object. Sets it to undefined or empty string if the<tr><td><a id="l129"></a><a href="#l129">129</a><td> * delete failed.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {Object|Function} obj The object or function to delete a key from.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {string} key The key to delete.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @throws {Error} In case of trying to set a read-only property<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @private<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.testing.PropertyReplacer.deleteKey_ = function(obj, key) {<tr><td><a id="l136"></a><a href="#l136">136</a><td> try {<tr><td><a id="l137"></a><a href="#l137">137</a><td> delete obj[key];<tr><td><a id="l138"></a><a href="#l138">138</a><td> // Delete has no effect for built-in properties of DOM nodes in FF.<tr><td><a id="l139"></a><a href="#l139">139</a><td> if (!goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l140"></a><a href="#l140">140</a><td> return;<tr><td><a id="l141"></a><a href="#l141">141</a><td> }<tr><td><a id="l142"></a><a href="#l142">142</a><td> } catch (e) {<tr><td><a id="l143"></a><a href="#l143">143</a><td> // IE throws TypeError when trying to delete properties of native objects<tr><td><a id="l144"></a><a href="#l144">144</a><td> // (e.g. DOM nodes or window), even if they have been added by JavaScript.<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> obj[key] = undefined;<tr><td><a id="l148"></a><a href="#l148">148</a><td> if (obj[key] == &#39;undefined&#39;) {<tr><td><a id="l149"></a><a href="#l149">149</a><td> // Some properties such as className in IE are always evaluated as string<tr><td><a id="l150"></a><a href="#l150">150</a><td> // so undefined will become &#39;undefined&#39;.<tr><td><a id="l151"></a><a href="#l151">151</a><td> obj[key] = &#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><tr><td><a id="l154"></a><a href="#l154">154</a><td> if (obj[key]) {<tr><td><a id="l155"></a><a href="#l155">155</a><td> throw Error(&#39;Cannot delete non configurable property &quot;&#39; + key + &#39;&quot; in &#39; +<tr><td><a id="l156"></a><a href="#l156">156</a><td> obj);<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><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> * Adds or changes a value in an object while saving its original state.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l164"></a><a href="#l164">164</a><td> * alter. See the constraints in the class description.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {string} key The key to change the value for.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {*} value The new value to set.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @throws {Error} In case of trying to set a read-only property.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.testing.PropertyReplacer.prototype.set = function(obj, key, value) {<tr><td><a id="l170"></a><a href="#l170">170</a><td> var origValue = goog.testing.PropertyReplacer.hasKey_(obj, key) ? obj[key] :<tr><td><a id="l171"></a><a href="#l171">171</a><td> goog.testing.PropertyReplacer.NO_SUCH_KEY_;<tr><td><a id="l172"></a><a href="#l172">172</a><td> this.original_.push({object: obj, key: key, value: origValue});<tr><td><a id="l173"></a><a href="#l173">173</a><td> obj[key] = value;<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td> // Check whether obj[key] was a read-only value and the assignment failed.<tr><td><a id="l176"></a><a href="#l176">176</a><td> // Also, check that we&#39;re not comparing returned pixel values when &quot;value&quot;<tr><td><a id="l177"></a><a href="#l177">177</a><td> // is 0. In other words, account for this case:<tr><td><a id="l178"></a><a href="#l178">178</a><td> // document.body.style.margin = 0;<tr><td><a id="l179"></a><a href="#l179">179</a><td> // document.body.style.margin; // returns &quot;0px&quot;<tr><td><a id="l180"></a><a href="#l180">180</a><td> if (obj[key] != value &amp;&amp; (value + &#39;px&#39;) != obj[key]) {<tr><td><a id="l181"></a><a href="#l181">181</a><td> throw Error(&#39;Cannot overwrite read-only property &quot;&#39; + key + &#39;&quot; in &#39; + obj);<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><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Changes an existing value in an object to another one of the same type while<tr><td><a id="l188"></a><a href="#l188">188</a><td> * saving its original state. The advantage of {@code replace} over {@link #set}<tr><td><a id="l189"></a><a href="#l189">189</a><td> * is that {@code replace} protects against typos and erroneously passing tests<tr><td><a id="l190"></a><a href="#l190">190</a><td> * after some members have been renamed during a refactoring.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l192"></a><a href="#l192">192</a><td> * alter. See the constraints in the class description.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {string} key The key to change the value for. It has to be present<tr><td><a id="l194"></a><a href="#l194">194</a><td> * either in {@code obj} or in its prototype chain.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {*} value The new value to set. It has to have the same type as the<tr><td><a id="l196"></a><a href="#l196">196</a><td> * original value. The types are compared with {@link goog.typeOf}.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @throws {Error} In case of missing key or type mismatch.<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.testing.PropertyReplacer.prototype.replace = function(obj, key, value) {<tr><td><a id="l200"></a><a href="#l200">200</a><td> if (!(key in obj)) {<tr><td><a id="l201"></a><a href="#l201">201</a><td> throw Error(&#39;Cannot replace missing property &quot;&#39; + key + &#39;&quot; in &#39; + obj);<tr><td><a id="l202"></a><a href="#l202">202</a><td> }<tr><td><a id="l203"></a><a href="#l203">203</a><td> if (goog.typeOf(obj[key]) != goog.typeOf(value)) {<tr><td><a id="l204"></a><a href="#l204">204</a><td> throw Error(&#39;Cannot replace property &quot;&#39; + key + &#39;&quot; in &#39; + obj +<tr><td><a id="l205"></a><a href="#l205">205</a><td> &#39; with a value of different type&#39;);<tr><td><a id="l206"></a><a href="#l206">206</a><td> }<tr><td><a id="l207"></a><a href="#l207">207</a><td> this.set(obj, key, value);<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>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Builds an object structure for the provided namespace path. Doesn&#39;t<tr><td><a id="l213"></a><a href="#l213">213</a><td> * overwrite those prefixes of the path that are already objects or functions.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {string} path The path to create or alter, e.g. &#39;goog.ui.Menu&#39;.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {*} value The value to set.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.testing.PropertyReplacer.prototype.setPath = function(path, value) {<tr><td><a id="l218"></a><a href="#l218">218</a><td> var parts = path.split(&#39;.&#39;);<tr><td><a id="l219"></a><a href="#l219">219</a><td> var obj = goog.global;<tr><td><a id="l220"></a><a href="#l220">220</a><td> for (var i = 0; i &lt; parts.length - 1; i++) {<tr><td><a id="l221"></a><a href="#l221">221</a><td> var part = parts[i];<tr><td><a id="l222"></a><a href="#l222">222</a><td> if (part == &#39;prototype&#39; &amp;&amp; !obj[part]) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> throw Error(&#39;Cannot set the prototype of &#39; + parts.slice(0, i).join(&#39;.&#39;));<tr><td><a id="l224"></a><a href="#l224">224</a><td> }<tr><td><a id="l225"></a><a href="#l225">225</a><td> if (!goog.isObject(obj[part]) &amp;&amp; !goog.isFunction(obj[part])) {<tr><td><a id="l226"></a><a href="#l226">226</a><td> this.set(obj, part, {});<tr><td><a id="l227"></a><a href="#l227">227</a><td> }<tr><td><a id="l228"></a><a href="#l228">228</a><td> obj = obj[part];<tr><td><a id="l229"></a><a href="#l229">229</a><td> }<tr><td><a id="l230"></a><a href="#l230">230</a><td> this.set(obj, parts[parts.length - 1], value);<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>/**<tr><td><a id="l235"></a><a href="#l235">235</a><td> * Deletes the key from the object while saving its original value.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l237"></a><a href="#l237">237</a><td> * alter. See the constraints in the class description.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @param {string} key The key to delete.<tr><td><a id="l239"></a><a href="#l239">239</a><td> */<tr><td><a id="l240"></a><a href="#l240">240</a><td>goog.testing.PropertyReplacer.prototype.remove = function(obj, key) {<tr><td><a id="l241"></a><a href="#l241">241</a><td> if (goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l242"></a><a href="#l242">242</a><td> this.original_.push({object: obj, key: key, value: obj[key]});<tr><td><a id="l243"></a><a href="#l243">243</a><td> goog.testing.PropertyReplacer.deleteKey_(obj, key);<tr><td><a id="l244"></a><a href="#l244">244</a><td> }<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<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>/**<tr><td><a id="l249"></a><a href="#l249">249</a><td> * Resets all changes made by goog.testing.PropertyReplacer.prototype.set.<tr><td><a id="l250"></a><a href="#l250">250</a><td> */<tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.testing.PropertyReplacer.prototype.reset = function() {<tr><td><a id="l252"></a><a href="#l252">252</a><td> for (var i = this.original_.length - 1; i &gt;= 0; i--) {<tr><td><a id="l253"></a><a href="#l253">253</a><td> var original = this.original_[i];<tr><td><a id="l254"></a><a href="#l254">254</a><td> if (original.value == goog.testing.PropertyReplacer.NO_SUCH_KEY_) {<tr><td><a id="l255"></a><a href="#l255">255</a><td> goog.testing.PropertyReplacer.deleteKey_(original.object, original.key);<tr><td><a id="l256"></a><a href="#l256">256</a><td> } else {<tr><td><a id="l257"></a><a href="#l257">257</a><td> original.object[original.key] = original.value;<tr><td><a id="l258"></a><a href="#l258">258</a><td> }<tr><td><a id="l259"></a><a href="#l259">259</a><td> delete this.original_[i];<tr><td><a id="l260"></a><a href="#l260">260</a><td> }<tr><td><a id="l261"></a><a href="#l261">261</a><td> this.original_.length = 0;<tr><td><a id="l262"></a><a href="#l262">262</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>