selenium-webdriver 2.48.2 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (524) hide show
  1. package/CHANGES.md +57 -0
  2. package/NOTICE +1 -1
  3. package/README.md +56 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +79 -87
  12. package/firefox/extension.js +10 -18
  13. package/firefox/index.js +173 -173
  14. package/firefox/profile.js +220 -240
  15. package/http/index.js +396 -79
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +88 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +5 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/{webdriver/promise.js → promise.js} +688 -644
  34. package/lib/session.js +79 -0
  35. package/lib/{webdriver/serializable.js → symbols.js} +11 -16
  36. package/lib/test/build.js +4 -4
  37. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  38. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  39. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  40. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  41. package/lib/test/data/readOnlyPage.html +1 -1
  42. package/lib/test/data/selectPage.html +18 -2
  43. package/lib/test/fileserver.js +3 -4
  44. package/lib/test/index.js +7 -3
  45. package/lib/test/resources.js +1 -1
  46. package/lib/until.js +428 -0
  47. package/lib/webdriver.js +2351 -0
  48. package/net/portprober.js +15 -11
  49. package/opera.js +295 -314
  50. package/package.json +6 -5
  51. package/phantomjs.js +135 -140
  52. package/proxy.js +6 -4
  53. package/remote/index.js +229 -221
  54. package/safari.js +319 -310
  55. package/test/chrome/options_test.js +11 -9
  56. package/test/element_finding_test.js +51 -13
  57. package/test/error_test.js +163 -0
  58. package/test/execute_script_test.js +1 -1
  59. package/test/http/http_test.js +317 -55
  60. package/test/http/util_test.js +25 -23
  61. package/test/io_test.js +6 -1
  62. package/test/lib/by_test.js +127 -0
  63. package/test/lib/capabilities_test.js +84 -0
  64. package/test/lib/events_test.js +177 -0
  65. package/test/lib/logging_test.js +272 -0
  66. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  67. package/test/lib/promise_error_test.js +808 -0
  68. package/test/lib/promise_flow_test.js +2282 -0
  69. package/test/lib/promise_generator_test.js +308 -0
  70. package/test/lib/promise_test.js +996 -0
  71. package/test/lib/testutil.js +90 -0
  72. package/test/lib/until_test.js +436 -0
  73. package/test/lib/webdriver_test.js +2207 -0
  74. package/test/page_loading_test.js +7 -9
  75. package/test/stale_element_test.js +2 -2
  76. package/test/testing/assert_test.js +374 -0
  77. package/test/testing/index_test.js +9 -11
  78. package/testing/assert.js +334 -17
  79. package/testing/index.js +10 -0
  80. package/_base.js +0 -200
  81. package/docs/Changes.html +0 -356
  82. package/docs/class_bot_Error.html +0 -15
  83. package/docs/class_webdriver_ActionSequence.html +0 -115
  84. package/docs/class_webdriver_Alert.html +0 -24
  85. package/docs/class_webdriver_AlertPromise.html +0 -92
  86. package/docs/class_webdriver_Capabilities.html +0 -60
  87. package/docs/class_webdriver_Command.html +0 -15
  88. package/docs/class_webdriver_EventEmitter.html +0 -35
  89. package/docs/class_webdriver_FileDetector.html +0 -21
  90. package/docs/class_webdriver_Locator.html +0 -12
  91. package/docs/class_webdriver_Serializable.html +0 -9
  92. package/docs/class_webdriver_Session.html +0 -13
  93. package/docs/class_webdriver_TouchSequence.html +0 -49
  94. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  95. package/docs/class_webdriver_WebDriver.html +0 -313
  96. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  97. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  98. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  99. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  100. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  101. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  102. package/docs/class_webdriver_WebElement.html +0 -223
  103. package/docs/class_webdriver_WebElementPromise.html +0 -274
  104. package/docs/class_webdriver_http_Executor.html +0 -22
  105. package/docs/class_webdriver_http_Request.html +0 -12
  106. package/docs/class_webdriver_http_Response.html +0 -13
  107. package/docs/class_webdriver_logging_Entry.html +0 -15
  108. package/docs/class_webdriver_logging_Level.html +0 -55
  109. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  110. package/docs/class_webdriver_logging_Logger.html +0 -119
  111. package/docs/class_webdriver_logging_Preferences.html +0 -8
  112. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  113. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  114. package/docs/class_webdriver_promise_Deferred.html +0 -84
  115. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  116. package/docs/class_webdriver_promise_Promise.html +0 -75
  117. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  118. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  119. package/docs/class_webdriver_testing_Assertion.html +0 -99
  120. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  121. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  122. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  123. package/docs/class_webdriver_until_Condition.html +0 -7
  124. package/docs/dossier.css +0 -1
  125. package/docs/dossier.js +0 -86
  126. package/docs/enum_bot_ErrorCode.html +0 -3
  127. package/docs/enum_bot_Error_State.html +0 -2
  128. package/docs/enum_webdriver_Browser.html +0 -2
  129. package/docs/enum_webdriver_Button.html +0 -2
  130. package/docs/enum_webdriver_Capability.html +0 -33
  131. package/docs/enum_webdriver_CommandName.html +0 -3
  132. package/docs/enum_webdriver_Key.html +0 -12
  133. package/docs/enum_webdriver_logging_Type.html +0 -6
  134. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  135. package/docs/index.html +0 -125
  136. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  137. package/docs/interface_webdriver_http_Client.html +0 -10
  138. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  139. package/docs/module_selenium-webdriver.html +0 -23
  140. package/docs/module_selenium-webdriver__base.html +0 -23
  141. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  142. package/docs/module_selenium-webdriver_builder.html +0 -2
  143. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  144. package/docs/module_selenium-webdriver_chrome.html +0 -90
  145. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  146. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  147. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  148. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  149. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  150. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  151. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  152. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  153. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  154. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  155. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  156. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  157. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  158. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  159. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  160. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  161. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  162. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  163. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  164. package/docs/module_selenium-webdriver_error.html +0 -4
  165. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  166. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  167. package/docs/module_selenium-webdriver_executors.html +0 -10
  168. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  169. package/docs/module_selenium-webdriver_firefox.html +0 -68
  170. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  171. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  172. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  173. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  174. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  175. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  176. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  177. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  178. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_http.html +0 -9
  180. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  181. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  182. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  183. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  184. package/docs/module_selenium-webdriver_http_util.html +0 -17
  185. package/docs/module_selenium-webdriver_ie.html +0 -11
  186. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  187. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  188. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  189. package/docs/module_selenium-webdriver_io.html +0 -37
  190. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  191. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  192. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  193. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  194. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  195. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  196. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  197. package/docs/module_selenium-webdriver_net.html +0 -7
  198. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  199. package/docs/module_selenium-webdriver_opera.html +0 -62
  200. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  201. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  202. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  203. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  204. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  205. package/docs/module_selenium-webdriver_proxy.html +0 -28
  206. package/docs/module_selenium-webdriver_remote.html +0 -8
  207. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  208. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  209. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  210. package/docs/module_selenium-webdriver_safari.html +0 -9
  211. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  212. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  213. package/docs/module_selenium-webdriver_testing.html +0 -74
  214. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  215. package/docs/namespace_bot.html +0 -4
  216. package/docs/namespace_bot_json.html +0 -20
  217. package/docs/namespace_bot_response.html +0 -18
  218. package/docs/namespace_bot_userAgent.html +0 -33
  219. package/docs/namespace_webdriver.html +0 -30
  220. package/docs/namespace_webdriver_By.html +0 -56
  221. package/docs/namespace_webdriver_http.html +0 -6
  222. package/docs/namespace_webdriver_logging.html +0 -70
  223. package/docs/namespace_webdriver_promise.html +0 -688
  224. package/docs/namespace_webdriver_stacktrace.html +0 -17
  225. package/docs/namespace_webdriver_testing.html +0 -7
  226. package/docs/namespace_webdriver_testing_assert.html +0 -9
  227. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  228. package/docs/namespace_webdriver_until.html +0 -82
  229. package/docs/source/_base.js.src.html +0 -1
  230. package/docs/source/builder.js.src.html +0 -1
  231. package/docs/source/chrome.js.src.html +0 -1
  232. package/docs/source/error.js.src.html +0 -1
  233. package/docs/source/executors.js.src.html +0 -1
  234. package/docs/source/firefox/binary.js.src.html +0 -1
  235. package/docs/source/firefox/extension.js.src.html +0 -1
  236. package/docs/source/firefox/index.js.src.html +0 -1
  237. package/docs/source/firefox/profile.js.src.html +0 -1
  238. package/docs/source/http/index.js.src.html +0 -1
  239. package/docs/source/http/util.js.src.html +0 -1
  240. package/docs/source/ie.js.src.html +0 -1
  241. package/docs/source/index.js.src.html +0 -1
  242. package/docs/source/io/exec.js.src.html +0 -1
  243. package/docs/source/io/index.js.src.html +0 -1
  244. package/docs/source/lib/atoms/error.js.src.html +0 -1
  245. package/docs/source/lib/atoms/json.js.src.html +0 -1
  246. package/docs/source/lib/atoms/response.js.src.html +0 -1
  247. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  248. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  249. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  250. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  251. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  252. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  254. package/docs/source/lib/goog/base.js.src.html +0 -1
  255. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  256. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  257. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  261. package/docs/source/lib/goog/deps.js.src.html +0 -1
  262. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  263. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  264. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  265. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  266. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  271. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  272. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  273. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  282. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  283. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  284. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  285. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  286. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  291. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  292. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  293. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  294. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  295. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  296. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  304. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  305. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  306. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  310. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  311. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  314. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  315. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  316. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  318. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  319. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  320. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  322. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  323. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  326. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  327. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  328. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  344. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  345. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  346. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  347. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  348. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  349. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  350. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  351. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  366. package/docs/source/net/index.js.src.html +0 -1
  367. package/docs/source/net/portprober.js.src.html +0 -1
  368. package/docs/source/opera.js.src.html +0 -1
  369. package/docs/source/phantomjs.js.src.html +0 -1
  370. package/docs/source/proxy.js.src.html +0 -1
  371. package/docs/source/remote/index.js.src.html +0 -1
  372. package/docs/source/safari.js.src.html +0 -1
  373. package/docs/source/testing/assert.js.src.html +0 -1
  374. package/docs/source/testing/index.js.src.html +0 -1
  375. package/docs/types.js +0 -1
  376. package/lib/atoms/error.js +0 -202
  377. package/lib/atoms/json.js +0 -80
  378. package/lib/atoms/response.js +0 -110
  379. package/lib/atoms/userAgent.js +0 -257
  380. package/lib/goog/LICENSE +0 -176
  381. package/lib/goog/array/array.js +0 -1654
  382. package/lib/goog/asserts/asserts.js +0 -365
  383. package/lib/goog/async/freelist.js +0 -88
  384. package/lib/goog/async/nexttick.js +0 -241
  385. package/lib/goog/async/run.js +0 -133
  386. package/lib/goog/async/workqueue.js +0 -139
  387. package/lib/goog/base.js +0 -2548
  388. package/lib/goog/debug/debug.js +0 -653
  389. package/lib/goog/debug/entrypointregistry.js +0 -158
  390. package/lib/goog/debug/error.js +0 -63
  391. package/lib/goog/debug/logbuffer.js +0 -148
  392. package/lib/goog/debug/logger.js +0 -873
  393. package/lib/goog/debug/logrecord.js +0 -242
  394. package/lib/goog/deps.js +0 -151
  395. package/lib/goog/disposable/disposable.js +0 -307
  396. package/lib/goog/disposable/idisposable.js +0 -45
  397. package/lib/goog/dom/browserfeature.js +0 -72
  398. package/lib/goog/dom/dom.js +0 -2991
  399. package/lib/goog/dom/nodetype.js +0 -48
  400. package/lib/goog/dom/safe.js +0 -347
  401. package/lib/goog/dom/tagname.js +0 -160
  402. package/lib/goog/dom/tags.js +0 -41
  403. package/lib/goog/dom/vendor.js +0 -96
  404. package/lib/goog/events/browserevent.js +0 -400
  405. package/lib/goog/events/browserfeature.js +0 -85
  406. package/lib/goog/events/event.js +0 -143
  407. package/lib/goog/events/eventid.js +0 -47
  408. package/lib/goog/events/events.js +0 -984
  409. package/lib/goog/events/eventtarget.js +0 -394
  410. package/lib/goog/events/eventtype.js +0 -237
  411. package/lib/goog/events/keycodes.js +0 -427
  412. package/lib/goog/events/listenable.js +0 -335
  413. package/lib/goog/events/listener.js +0 -131
  414. package/lib/goog/events/listenermap.js +0 -308
  415. package/lib/goog/fs/url.js +0 -109
  416. package/lib/goog/functions/functions.js +0 -442
  417. package/lib/goog/html/safehtml.js +0 -757
  418. package/lib/goog/html/safescript.js +0 -234
  419. package/lib/goog/html/safestyle.js +0 -442
  420. package/lib/goog/html/safestylesheet.js +0 -276
  421. package/lib/goog/html/safeurl.js +0 -398
  422. package/lib/goog/html/trustedresourceurl.js +0 -224
  423. package/lib/goog/html/uncheckedconversions.js +0 -232
  424. package/lib/goog/i18n/bidi.js +0 -908
  425. package/lib/goog/iter/iter.js +0 -1302
  426. package/lib/goog/json/json.js +0 -363
  427. package/lib/goog/labs/testing/assertthat.js +0 -58
  428. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  429. package/lib/goog/labs/testing/matcher.js +0 -80
  430. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  431. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  432. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  433. package/lib/goog/labs/useragent/browser.js +0 -341
  434. package/lib/goog/labs/useragent/engine.js +0 -160
  435. package/lib/goog/labs/useragent/platform.js +0 -160
  436. package/lib/goog/labs/useragent/util.js +0 -148
  437. package/lib/goog/log/log.js +0 -197
  438. package/lib/goog/math/box.js +0 -398
  439. package/lib/goog/math/coordinate.js +0 -268
  440. package/lib/goog/math/math.js +0 -451
  441. package/lib/goog/math/rect.js +0 -476
  442. package/lib/goog/math/size.js +0 -227
  443. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  444. package/lib/goog/net/xhrlike.js +0 -124
  445. package/lib/goog/net/xmlhttp.js +0 -246
  446. package/lib/goog/net/xmlhttpfactory.js +0 -67
  447. package/lib/goog/object/object.js +0 -686
  448. package/lib/goog/promise/promise.js +0 -1350
  449. package/lib/goog/promise/resolver.js +0 -48
  450. package/lib/goog/promise/thenable.js +0 -126
  451. package/lib/goog/reflect/reflect.js +0 -77
  452. package/lib/goog/string/const.js +0 -182
  453. package/lib/goog/string/string.js +0 -1599
  454. package/lib/goog/string/typedstring.js +0 -48
  455. package/lib/goog/structs/collection.js +0 -56
  456. package/lib/goog/structs/map.js +0 -457
  457. package/lib/goog/structs/set.js +0 -279
  458. package/lib/goog/structs/structs.js +0 -354
  459. package/lib/goog/style/style.js +0 -2037
  460. package/lib/goog/testing/asserts.js +0 -1278
  461. package/lib/goog/testing/events/events.js +0 -767
  462. package/lib/goog/testing/functionmock.js +0 -175
  463. package/lib/goog/testing/jsunit.js +0 -162
  464. package/lib/goog/testing/loosemock.js +0 -242
  465. package/lib/goog/testing/mock.js +0 -645
  466. package/lib/goog/testing/mockclock.js +0 -606
  467. package/lib/goog/testing/mockcontrol.js +0 -220
  468. package/lib/goog/testing/mockinterface.js +0 -45
  469. package/lib/goog/testing/mockmatchers.js +0 -400
  470. package/lib/goog/testing/objectpropertystring.js +0 -68
  471. package/lib/goog/testing/propertyreplacer.js +0 -262
  472. package/lib/goog/testing/recordfunction.js +0 -215
  473. package/lib/goog/testing/stacktrace.js +0 -594
  474. package/lib/goog/testing/strictmock.js +0 -130
  475. package/lib/goog/testing/testcase.js +0 -1629
  476. package/lib/goog/testing/testrunner.js +0 -440
  477. package/lib/goog/uri/uri.js +0 -1524
  478. package/lib/goog/uri/utils.js +0 -1064
  479. package/lib/goog/useragent/product.js +0 -183
  480. package/lib/goog/useragent/product_isversion.js +0 -144
  481. package/lib/goog/useragent/useragent.js +0 -572
  482. package/lib/webdriver/actionsequence.js +0 -356
  483. package/lib/webdriver/builder.js +0 -207
  484. package/lib/webdriver/capabilities.js +0 -412
  485. package/lib/webdriver/events.js +0 -179
  486. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  487. package/lib/webdriver/http/corsclient.js +0 -133
  488. package/lib/webdriver/http/http.js +0 -525
  489. package/lib/webdriver/http/xhrclient.js +0 -67
  490. package/lib/webdriver/locators.js +0 -257
  491. package/lib/webdriver/logging.js +0 -347
  492. package/lib/webdriver/session.js +0 -74
  493. package/lib/webdriver/stacktrace.js +0 -619
  494. package/lib/webdriver/test/builder_test.js +0 -53
  495. package/lib/webdriver/test/capabilities_test.js +0 -72
  496. package/lib/webdriver/test/events_test.js +0 -203
  497. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  498. package/lib/webdriver/test/http/http_test.js +0 -428
  499. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  500. package/lib/webdriver/test/locators_test.js +0 -59
  501. package/lib/webdriver/test/logging_test.js +0 -85
  502. package/lib/webdriver/test/promise_error_test.js +0 -892
  503. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  504. package/lib/webdriver/test/promise_generator_test.js +0 -323
  505. package/lib/webdriver/test/promise_test.js +0 -2012
  506. package/lib/webdriver/test/stacktrace_test.js +0 -480
  507. package/lib/webdriver/test/test_bootstrap.js +0 -67
  508. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  509. package/lib/webdriver/test/testing/client_test.js +0 -88
  510. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  511. package/lib/webdriver/test/testutil.js +0 -209
  512. package/lib/webdriver/test/testutil_test.js +0 -104
  513. package/lib/webdriver/test/until_test.js +0 -411
  514. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  515. package/lib/webdriver/test/webdriver_test.js +0 -2369
  516. package/lib/webdriver/testing/asserts.js +0 -487
  517. package/lib/webdriver/testing/client.js +0 -179
  518. package/lib/webdriver/testing/jsunit.js +0 -363
  519. package/lib/webdriver/testing/testcase.js +0 -168
  520. package/lib/webdriver/testing/window.js +0 -244
  521. package/lib/webdriver/touchsequence.js +0 -248
  522. package/lib/webdriver/until.js +0 -412
  523. package/lib/webdriver/webdriver.js +0 -2511
  524. 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>