selenium-webdriver 2.47.0 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/CHANGES.md +96 -0
  2. package/NOTICE +1 -1
  3. package/README.md +57 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +80 -114
  12. package/firefox/extension.js +10 -19
  13. package/firefox/index.js +175 -171
  14. package/firefox/profile.js +221 -239
  15. package/http/index.js +396 -77
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +89 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +6 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/promise.js +3093 -0
  34. package/lib/safari/client.js +697 -659
  35. package/lib/session.js +79 -0
  36. package/{test/promise_aplus_test.js → lib/symbols.js} +15 -25
  37. package/lib/test/build.js +4 -4
  38. package/lib/test/data/click_tests/disappearing_element.html +62 -0
  39. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  40. package/lib/test/data/click_tests/overlapping_elements.html +70 -0
  41. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  42. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  43. package/lib/test/data/readOnlyPage.html +3 -1
  44. package/lib/test/data/selectPage.html +18 -2
  45. package/lib/test/data/simpleTest.html +1 -0
  46. package/lib/test/fileserver.js +3 -4
  47. package/lib/test/index.js +13 -4
  48. package/lib/test/resources.js +1 -1
  49. package/lib/until.js +428 -0
  50. package/lib/webdriver.js +2351 -0
  51. package/net/portprober.js +15 -11
  52. package/opera.js +295 -314
  53. package/package.json +6 -5
  54. package/phantomjs.js +135 -140
  55. package/proxy.js +6 -4
  56. package/remote/index.js +234 -219
  57. package/safari.js +319 -310
  58. package/test/chrome/options_test.js +11 -9
  59. package/test/element_finding_test.js +51 -13
  60. package/test/error_test.js +163 -0
  61. package/test/execute_script_test.js +1 -1
  62. package/test/firefox/firefox_test.js +24 -0
  63. package/test/http/http_test.js +354 -43
  64. package/test/http/util_test.js +25 -23
  65. package/test/io_test.js +6 -1
  66. package/test/lib/by_test.js +127 -0
  67. package/test/lib/capabilities_test.js +84 -0
  68. package/test/lib/events_test.js +177 -0
  69. package/test/lib/logging_test.js +272 -0
  70. package/test/lib/promise_aplus_test.js +74 -0
  71. package/test/lib/promise_error_test.js +808 -0
  72. package/test/lib/promise_flow_test.js +2282 -0
  73. package/test/lib/promise_generator_test.js +308 -0
  74. package/test/lib/promise_test.js +996 -0
  75. package/test/lib/testutil.js +90 -0
  76. package/test/lib/until_test.js +436 -0
  77. package/test/lib/webdriver_test.js +2207 -0
  78. package/test/page_loading_test.js +7 -9
  79. package/test/stale_element_test.js +2 -2
  80. package/test/testing/assert_test.js +374 -0
  81. package/test/testing/index_test.js +9 -11
  82. package/testing/assert.js +334 -17
  83. package/testing/index.js +10 -0
  84. package/_base.js +0 -200
  85. package/docs/Changes.html +0 -317
  86. package/docs/class_bot_Error.html +0 -15
  87. package/docs/class_webdriver_ActionSequence.html +0 -115
  88. package/docs/class_webdriver_Alert.html +0 -24
  89. package/docs/class_webdriver_AlertPromise.html +0 -91
  90. package/docs/class_webdriver_Capabilities.html +0 -60
  91. package/docs/class_webdriver_Command.html +0 -15
  92. package/docs/class_webdriver_EventEmitter.html +0 -35
  93. package/docs/class_webdriver_FileDetector.html +0 -21
  94. package/docs/class_webdriver_Locator.html +0 -12
  95. package/docs/class_webdriver_Serializable.html +0 -9
  96. package/docs/class_webdriver_Session.html +0 -13
  97. package/docs/class_webdriver_TouchSequence.html +0 -49
  98. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  99. package/docs/class_webdriver_WebDriver.html +0 -313
  100. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  101. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  102. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  103. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  104. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  105. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  106. package/docs/class_webdriver_WebElement.html +0 -216
  107. package/docs/class_webdriver_WebElementPromise.html +0 -266
  108. package/docs/class_webdriver_http_Executor.html +0 -22
  109. package/docs/class_webdriver_http_Request.html +0 -12
  110. package/docs/class_webdriver_http_Response.html +0 -13
  111. package/docs/class_webdriver_logging_Entry.html +0 -15
  112. package/docs/class_webdriver_logging_Level.html +0 -55
  113. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  114. package/docs/class_webdriver_logging_Logger.html +0 -119
  115. package/docs/class_webdriver_logging_Preferences.html +0 -8
  116. package/docs/class_webdriver_promise_CancellationError.html +0 -18
  117. package/docs/class_webdriver_promise_ControlFlow.html +0 -109
  118. package/docs/class_webdriver_promise_Deferred.html +0 -84
  119. package/docs/class_webdriver_promise_Promise.html +0 -74
  120. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  121. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  122. package/docs/class_webdriver_testing_Assertion.html +0 -99
  123. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  124. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  125. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  126. package/docs/class_webdriver_until_Condition.html +0 -7
  127. package/docs/dossier.css +0 -1
  128. package/docs/dossier.js +0 -86
  129. package/docs/enum_bot_ErrorCode.html +0 -3
  130. package/docs/enum_bot_Error_State.html +0 -2
  131. package/docs/enum_webdriver_Browser.html +0 -2
  132. package/docs/enum_webdriver_Button.html +0 -2
  133. package/docs/enum_webdriver_Capability.html +0 -33
  134. package/docs/enum_webdriver_CommandName.html +0 -3
  135. package/docs/enum_webdriver_Key.html +0 -12
  136. package/docs/enum_webdriver_logging_Type.html +0 -6
  137. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  138. package/docs/index.html +0 -123
  139. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  140. package/docs/interface_webdriver_http_Client.html +0 -10
  141. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  142. package/docs/module_selenium-webdriver.html +0 -23
  143. package/docs/module_selenium-webdriver__base.html +0 -23
  144. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  145. package/docs/module_selenium-webdriver_builder.html +0 -2
  146. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  147. package/docs/module_selenium-webdriver_chrome.html +0 -90
  148. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  149. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  150. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  151. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  152. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  153. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  154. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  155. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  156. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  157. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  158. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  159. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  160. package/docs/module_selenium-webdriver_class_WebElement.html +0 -216
  161. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -266
  162. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  163. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  164. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  165. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  166. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  167. package/docs/module_selenium-webdriver_error.html +0 -4
  168. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  169. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  170. package/docs/module_selenium-webdriver_executors.html +0 -10
  171. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  172. package/docs/module_selenium-webdriver_firefox.html +0 -67
  173. package/docs/module_selenium-webdriver_firefox_binary.html +0 -4
  174. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -21
  175. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -21
  176. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  177. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  178. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  180. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  181. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  182. package/docs/module_selenium-webdriver_http.html +0 -9
  183. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  184. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  185. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  186. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  187. package/docs/module_selenium-webdriver_http_util.html +0 -17
  188. package/docs/module_selenium-webdriver_ie.html +0 -11
  189. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  190. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  191. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  192. package/docs/module_selenium-webdriver_io.html +0 -37
  193. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  194. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  195. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  196. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  197. package/docs/module_selenium-webdriver_namespace_promise.html +0 -162
  198. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  199. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  200. package/docs/module_selenium-webdriver_net.html +0 -7
  201. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  202. package/docs/module_selenium-webdriver_opera.html +0 -62
  203. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  204. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  205. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  206. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  207. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  208. package/docs/module_selenium-webdriver_proxy.html +0 -28
  209. package/docs/module_selenium-webdriver_remote.html +0 -8
  210. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  211. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  212. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -40
  213. package/docs/module_selenium-webdriver_safari.html +0 -9
  214. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  215. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  216. package/docs/module_selenium-webdriver_testing.html +0 -74
  217. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  218. package/docs/namespace_bot.html +0 -4
  219. package/docs/namespace_bot_json.html +0 -20
  220. package/docs/namespace_bot_response.html +0 -18
  221. package/docs/namespace_bot_userAgent.html +0 -33
  222. package/docs/namespace_webdriver.html +0 -30
  223. package/docs/namespace_webdriver_By.html +0 -56
  224. package/docs/namespace_webdriver_http.html +0 -6
  225. package/docs/namespace_webdriver_logging.html +0 -70
  226. package/docs/namespace_webdriver_promise.html +0 -165
  227. package/docs/namespace_webdriver_stacktrace.html +0 -17
  228. package/docs/namespace_webdriver_testing.html +0 -7
  229. package/docs/namespace_webdriver_testing_assert.html +0 -9
  230. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  231. package/docs/namespace_webdriver_until.html +0 -82
  232. package/docs/source/_base.js.src.html +0 -1
  233. package/docs/source/builder.js.src.html +0 -1
  234. package/docs/source/chrome.js.src.html +0 -1
  235. package/docs/source/error.js.src.html +0 -1
  236. package/docs/source/executors.js.src.html +0 -1
  237. package/docs/source/firefox/binary.js.src.html +0 -1
  238. package/docs/source/firefox/extension.js.src.html +0 -1
  239. package/docs/source/firefox/index.js.src.html +0 -1
  240. package/docs/source/firefox/profile.js.src.html +0 -1
  241. package/docs/source/http/index.js.src.html +0 -1
  242. package/docs/source/http/util.js.src.html +0 -1
  243. package/docs/source/ie.js.src.html +0 -1
  244. package/docs/source/index.js.src.html +0 -1
  245. package/docs/source/io/exec.js.src.html +0 -1
  246. package/docs/source/io/index.js.src.html +0 -1
  247. package/docs/source/lib/atoms/error.js.src.html +0 -1
  248. package/docs/source/lib/atoms/json.js.src.html +0 -1
  249. package/docs/source/lib/atoms/response.js.src.html +0 -1
  250. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  251. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  252. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  254. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  255. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  256. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  257. package/docs/source/lib/goog/base.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  261. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  262. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  263. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  264. package/docs/source/lib/goog/deps.js.src.html +0 -1
  265. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  266. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  271. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  272. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  273. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  285. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  286. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  291. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  292. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  293. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  294. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  295. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  296. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  310. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  311. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  314. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  315. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  316. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  318. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  319. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  320. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  322. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  323. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  326. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  327. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  328. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/watchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  348. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  349. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  350. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  351. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  369. package/docs/source/net/index.js.src.html +0 -1
  370. package/docs/source/net/portprober.js.src.html +0 -1
  371. package/docs/source/opera.js.src.html +0 -1
  372. package/docs/source/phantomjs.js.src.html +0 -1
  373. package/docs/source/proxy.js.src.html +0 -1
  374. package/docs/source/remote/index.js.src.html +0 -1
  375. package/docs/source/safari.js.src.html +0 -1
  376. package/docs/source/testing/assert.js.src.html +0 -1
  377. package/docs/source/testing/index.js.src.html +0 -1
  378. package/docs/types.js +0 -1
  379. package/lib/atoms/error.js +0 -202
  380. package/lib/atoms/json.js +0 -80
  381. package/lib/atoms/response.js +0 -110
  382. package/lib/atoms/userAgent.js +0 -257
  383. package/lib/goog/LICENSE +0 -176
  384. package/lib/goog/array/array.js +0 -1655
  385. package/lib/goog/asserts/asserts.js +0 -365
  386. package/lib/goog/async/freelist.js +0 -88
  387. package/lib/goog/async/nexttick.js +0 -241
  388. package/lib/goog/async/run.js +0 -139
  389. package/lib/goog/async/workqueue.js +0 -139
  390. package/lib/goog/base.js +0 -2547
  391. package/lib/goog/debug/debug.js +0 -653
  392. package/lib/goog/debug/entrypointregistry.js +0 -158
  393. package/lib/goog/debug/error.js +0 -63
  394. package/lib/goog/debug/logbuffer.js +0 -148
  395. package/lib/goog/debug/logger.js +0 -873
  396. package/lib/goog/debug/logrecord.js +0 -242
  397. package/lib/goog/deps.js +0 -151
  398. package/lib/goog/disposable/disposable.js +0 -307
  399. package/lib/goog/disposable/idisposable.js +0 -45
  400. package/lib/goog/dom/browserfeature.js +0 -72
  401. package/lib/goog/dom/dom.js +0 -2995
  402. package/lib/goog/dom/nodetype.js +0 -48
  403. package/lib/goog/dom/safe.js +0 -347
  404. package/lib/goog/dom/tagname.js +0 -160
  405. package/lib/goog/dom/tags.js +0 -42
  406. package/lib/goog/dom/vendor.js +0 -96
  407. package/lib/goog/events/browserevent.js +0 -386
  408. package/lib/goog/events/browserfeature.js +0 -85
  409. package/lib/goog/events/event.js +0 -143
  410. package/lib/goog/events/eventid.js +0 -47
  411. package/lib/goog/events/events.js +0 -984
  412. package/lib/goog/events/eventtarget.js +0 -394
  413. package/lib/goog/events/eventtype.js +0 -233
  414. package/lib/goog/events/keycodes.js +0 -420
  415. package/lib/goog/events/listenable.js +0 -335
  416. package/lib/goog/events/listener.js +0 -131
  417. package/lib/goog/events/listenermap.js +0 -308
  418. package/lib/goog/fs/url.js +0 -105
  419. package/lib/goog/functions/functions.js +0 -332
  420. package/lib/goog/html/safehtml.js +0 -756
  421. package/lib/goog/html/safescript.js +0 -234
  422. package/lib/goog/html/safestyle.js +0 -442
  423. package/lib/goog/html/safestylesheet.js +0 -276
  424. package/lib/goog/html/safeurl.js +0 -431
  425. package/lib/goog/html/trustedresourceurl.js +0 -224
  426. package/lib/goog/html/uncheckedconversions.js +0 -231
  427. package/lib/goog/i18n/bidi.js +0 -908
  428. package/lib/goog/iter/iter.js +0 -1305
  429. package/lib/goog/json/json.js +0 -365
  430. package/lib/goog/labs/testing/assertthat.js +0 -58
  431. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  432. package/lib/goog/labs/testing/matcher.js +0 -80
  433. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  434. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  435. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  436. package/lib/goog/labs/useragent/browser.js +0 -327
  437. package/lib/goog/labs/useragent/engine.js +0 -160
  438. package/lib/goog/labs/useragent/platform.js +0 -160
  439. package/lib/goog/labs/useragent/util.js +0 -148
  440. package/lib/goog/math/box.js +0 -389
  441. package/lib/goog/math/coordinate.js +0 -268
  442. package/lib/goog/math/math.js +0 -451
  443. package/lib/goog/math/rect.js +0 -476
  444. package/lib/goog/math/size.js +0 -227
  445. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  446. package/lib/goog/net/xhrlike.js +0 -124
  447. package/lib/goog/net/xmlhttp.js +0 -246
  448. package/lib/goog/net/xmlhttpfactory.js +0 -67
  449. package/lib/goog/object/object.js +0 -686
  450. package/lib/goog/promise/promise.js +0 -1310
  451. package/lib/goog/promise/resolver.js +0 -48
  452. package/lib/goog/promise/thenable.js +0 -126
  453. package/lib/goog/reflect/reflect.js +0 -78
  454. package/lib/goog/string/const.js +0 -182
  455. package/lib/goog/string/string.js +0 -1565
  456. package/lib/goog/string/typedstring.js +0 -48
  457. package/lib/goog/structs/collection.js +0 -56
  458. package/lib/goog/structs/map.js +0 -456
  459. package/lib/goog/structs/set.js +0 -279
  460. package/lib/goog/structs/structs.js +0 -354
  461. package/lib/goog/style/style.js +0 -2054
  462. package/lib/goog/testing/asserts.js +0 -1265
  463. package/lib/goog/testing/events/events.js +0 -727
  464. package/lib/goog/testing/functionmock.js +0 -176
  465. package/lib/goog/testing/jsunit.js +0 -162
  466. package/lib/goog/testing/loosemock.js +0 -242
  467. package/lib/goog/testing/mock.js +0 -645
  468. package/lib/goog/testing/mockclock.js +0 -617
  469. package/lib/goog/testing/mockcontrol.js +0 -220
  470. package/lib/goog/testing/mockinterface.js +0 -45
  471. package/lib/goog/testing/mockmatchers.js +0 -400
  472. package/lib/goog/testing/objectpropertystring.js +0 -68
  473. package/lib/goog/testing/propertyreplacer.js +0 -245
  474. package/lib/goog/testing/recordfunction.js +0 -215
  475. package/lib/goog/testing/stacktrace.js +0 -594
  476. package/lib/goog/testing/strictmock.js +0 -130
  477. package/lib/goog/testing/testcase.js +0 -1569
  478. package/lib/goog/testing/testrunner.js +0 -440
  479. package/lib/goog/testing/watchers.js +0 -46
  480. package/lib/goog/uri/uri.js +0 -1507
  481. package/lib/goog/uri/utils.js +0 -1116
  482. package/lib/goog/useragent/product.js +0 -175
  483. package/lib/goog/useragent/product_isversion.js +0 -143
  484. package/lib/goog/useragent/useragent.js +0 -538
  485. package/lib/webdriver/actionsequence.js +0 -356
  486. package/lib/webdriver/builder.js +0 -208
  487. package/lib/webdriver/capabilities.js +0 -411
  488. package/lib/webdriver/events.js +0 -179
  489. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  490. package/lib/webdriver/http/corsclient.js +0 -133
  491. package/lib/webdriver/http/http.js +0 -523
  492. package/lib/webdriver/http/xhrclient.js +0 -67
  493. package/lib/webdriver/locators.js +0 -257
  494. package/lib/webdriver/logging.js +0 -347
  495. package/lib/webdriver/promise.js +0 -2609
  496. package/lib/webdriver/serializable.js +0 -41
  497. package/lib/webdriver/session.js +0 -74
  498. package/lib/webdriver/stacktrace.js +0 -619
  499. package/lib/webdriver/test/builder_test.js +0 -53
  500. package/lib/webdriver/test/capabilities_test.js +0 -72
  501. package/lib/webdriver/test/events_test.js +0 -203
  502. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  503. package/lib/webdriver/test/http/http_test.js +0 -428
  504. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  505. package/lib/webdriver/test/locators_test.js +0 -59
  506. package/lib/webdriver/test/logging_test.js +0 -85
  507. package/lib/webdriver/test/promise_error_test.js +0 -719
  508. package/lib/webdriver/test/promise_flow_test.js +0 -1957
  509. package/lib/webdriver/test/promise_generator_test.js +0 -251
  510. package/lib/webdriver/test/promise_test.js +0 -1981
  511. package/lib/webdriver/test/stacktrace_test.js +0 -480
  512. package/lib/webdriver/test/test_bootstrap.js +0 -67
  513. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  514. package/lib/webdriver/test/testing/client_test.js +0 -88
  515. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  516. package/lib/webdriver/test/testutil.js +0 -209
  517. package/lib/webdriver/test/testutil_test.js +0 -104
  518. package/lib/webdriver/test/until_test.js +0 -411
  519. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  520. package/lib/webdriver/test/webdriver_test.js +0 -2369
  521. package/lib/webdriver/testing/asserts.js +0 -487
  522. package/lib/webdriver/testing/client.js +0 -179
  523. package/lib/webdriver/testing/jsunit.js +0 -363
  524. package/lib/webdriver/testing/testcase.js +0 -168
  525. package/lib/webdriver/testing/window.js +0 -244
  526. package/lib/webdriver/touchsequence.js +0 -248
  527. package/lib/webdriver/until.js +0 -412
  528. package/lib/webdriver/webdriver.js +0 -2492
  529. package/test/_base_test.js +0 -129
package/docs/source/lib/goog/debug/debug.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>debug.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/debug/debug.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 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 Logging and debugging utilities.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @see ../demos/debug.html<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.debug&#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>goog.require(&#39;goog.array&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.html.uncheckedconversions&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.structs.Set&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/** @define {boolean} Whether logging should be enabled. */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.define(&#39;goog.debug.LOGGING_ENABLED&#39;, goog.DEBUG);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>/**<tr><td><a id="l37"></a><a href="#l37">37</a><td> * Catches onerror events fired by windows and similar objects.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {function(Object)} logFunc The function to call with the error<tr><td><a id="l39"></a><a href="#l39">39</a><td> * information.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @param {boolean=} opt_cancel Whether to stop the error from reaching the<tr><td><a id="l41"></a><a href="#l41">41</a><td> * browser.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @param {Object=} opt_target Object that fires onerror events.<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.debug.catchErrors = function(logFunc, opt_cancel, opt_target) {<tr><td><a id="l45"></a><a href="#l45">45</a><td> var target = opt_target || goog.global;<tr><td><a id="l46"></a><a href="#l46">46</a><td> var oldErrorHandler = target.onerror;<tr><td><a id="l47"></a><a href="#l47">47</a><td> var retVal = !!opt_cancel;<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td> // Chrome interprets onerror return value backwards (http://crbug.com/92062)<tr><td><a id="l50"></a><a href="#l50">50</a><td> // until it was fixed in webkit revision r94061 (Webkit 535.3). This<tr><td><a id="l51"></a><a href="#l51">51</a><td> // workaround still needs to be skipped in Safari after the webkit change<tr><td><a id="l52"></a><a href="#l52">52</a><td> // gets pushed out in Safari.<tr><td><a id="l53"></a><a href="#l53">53</a><td> // See https://bugs.webkit.org/show_bug.cgi?id=67119<tr><td><a id="l54"></a><a href="#l54">54</a><td> if (goog.userAgent.WEBKIT &amp;&amp;<tr><td><a id="l55"></a><a href="#l55">55</a><td> !goog.userAgent.isVersionOrHigher(&#39;535.3&#39;)) {<tr><td><a id="l56"></a><a href="#l56">56</a><td> retVal = !retVal;<tr><td><a id="l57"></a><a href="#l57">57</a><td> }<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td> /**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * New onerror handler for this target. This onerror handler follows the spec<tr><td><a id="l61"></a><a href="#l61">61</a><td> * according to<tr><td><a id="l62"></a><a href="#l62">62</a><td> * http://www.whatwg.org/specs/web-apps/current-work/#runtime-script-errors<tr><td><a id="l63"></a><a href="#l63">63</a><td> * The spec was changed in August 2013 to support receiving column information<tr><td><a id="l64"></a><a href="#l64">64</a><td> * and an error object for all scripts on the same origin or cross origin<tr><td><a id="l65"></a><a href="#l65">65</a><td> * scripts with the proper headers. See<tr><td><a id="l66"></a><a href="#l66">66</a><td> * https://mikewest.org/2013/08/debugging-runtime-errors-with-window-onerror<tr><td><a id="l67"></a><a href="#l67">67</a><td> *<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @param {string} message The error message. For cross-origin errors, this<tr><td><a id="l69"></a><a href="#l69">69</a><td> * will be scrubbed to just &quot;Script error.&quot;. For new browsers that have<tr><td><a id="l70"></a><a href="#l70">70</a><td> * updated to follow the latest spec, errors that come from origins that<tr><td><a id="l71"></a><a href="#l71">71</a><td> * have proper cross origin headers will not be scrubbed.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {string} url The URL of the script that caused the error. The URL<tr><td><a id="l73"></a><a href="#l73">73</a><td> * will be scrubbed to &quot;&quot; for cross origin scripts unless the script has<tr><td><a id="l74"></a><a href="#l74">74</a><td> * proper cross origin headers and the browser has updated to the latest<tr><td><a id="l75"></a><a href="#l75">75</a><td> * spec.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {number} line The line number in the script that the error<tr><td><a id="l77"></a><a href="#l77">77</a><td> * occurred on.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @param {number=} opt_col The optional column number that the error<tr><td><a id="l79"></a><a href="#l79">79</a><td> * occurred on. Only browsers that have updated to the latest spec will<tr><td><a id="l80"></a><a href="#l80">80</a><td> * include this.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {Error=} opt_error The optional actual error object for this<tr><td><a id="l82"></a><a href="#l82">82</a><td> * error that should include the stack. Only browsers that have updated<tr><td><a id="l83"></a><a href="#l83">83</a><td> * to the latest spec will inlude this parameter.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @return {boolean} Whether to prevent the error from reaching the browser.<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td> target.onerror = function(message, url, line, opt_col, opt_error) {<tr><td><a id="l87"></a><a href="#l87">87</a><td> if (oldErrorHandler) {<tr><td><a id="l88"></a><a href="#l88">88</a><td> oldErrorHandler(message, url, line, opt_col, opt_error);<tr><td><a id="l89"></a><a href="#l89">89</a><td> }<tr><td><a id="l90"></a><a href="#l90">90</a><td> logFunc({<tr><td><a id="l91"></a><a href="#l91">91</a><td> message: message,<tr><td><a id="l92"></a><a href="#l92">92</a><td> fileName: url,<tr><td><a id="l93"></a><a href="#l93">93</a><td> line: line,<tr><td><a id="l94"></a><a href="#l94">94</a><td> col: opt_col,<tr><td><a id="l95"></a><a href="#l95">95</a><td> error: opt_error<tr><td><a id="l96"></a><a href="#l96">96</a><td> });<tr><td><a id="l97"></a><a href="#l97">97</a><td> return retVal;<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><tr><td><a id="l102"></a><a href="#l102">102</a><td>/**<tr><td><a id="l103"></a><a href="#l103">103</a><td> * Creates a string representing an object and all its properties.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {Object|null|undefined} obj Object to expose.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {boolean=} opt_showFn Show the functions as well as the properties,<tr><td><a id="l106"></a><a href="#l106">106</a><td> * default is false.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @return {string} The string representation of {@code obj}.<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>goog.debug.expose = function(obj, opt_showFn) {<tr><td><a id="l110"></a><a href="#l110">110</a><td> if (typeof obj == &#39;undefined&#39;) {<tr><td><a id="l111"></a><a href="#l111">111</a><td> return &#39;undefined&#39;;<tr><td><a id="l112"></a><a href="#l112">112</a><td> }<tr><td><a id="l113"></a><a href="#l113">113</a><td> if (obj == null) {<tr><td><a id="l114"></a><a href="#l114">114</a><td> return &#39;NULL&#39;;<tr><td><a id="l115"></a><a href="#l115">115</a><td> }<tr><td><a id="l116"></a><a href="#l116">116</a><td> var str = [];<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td> for (var x in obj) {<tr><td><a id="l119"></a><a href="#l119">119</a><td> if (!opt_showFn &amp;&amp; goog.isFunction(obj[x])) {<tr><td><a id="l120"></a><a href="#l120">120</a><td> continue;<tr><td><a id="l121"></a><a href="#l121">121</a><td> }<tr><td><a id="l122"></a><a href="#l122">122</a><td> var s = x + &#39; = &#39;;<tr><td><a id="l123"></a><a href="#l123">123</a><td> /** @preserveTry */<tr><td><a id="l124"></a><a href="#l124">124</a><td> try {<tr><td><a id="l125"></a><a href="#l125">125</a><td> s += obj[x];<tr><td><a id="l126"></a><a href="#l126">126</a><td> } catch (e) {<tr><td><a id="l127"></a><a href="#l127">127</a><td> s += &#39;*** &#39; + e + &#39; ***&#39;;<tr><td><a id="l128"></a><a href="#l128">128</a><td> }<tr><td><a id="l129"></a><a href="#l129">129</a><td> str.push(s);<tr><td><a id="l130"></a><a href="#l130">130</a><td> }<tr><td><a id="l131"></a><a href="#l131">131</a><td> return str.join(&#39;\n&#39;);<tr><td><a id="l132"></a><a href="#l132">132</a><td>};<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Creates a string representing a given primitive or object, and for an<tr><td><a id="l137"></a><a href="#l137">137</a><td> * object, all its properties and nested objects. WARNING: If an object is<tr><td><a id="l138"></a><a href="#l138">138</a><td> * given, it and all its nested objects will be modified. To detect reference<tr><td><a id="l139"></a><a href="#l139">139</a><td> * cycles, this method identifies objects using goog.getUid() which mutates the<tr><td><a id="l140"></a><a href="#l140">140</a><td> * object.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {*} obj Object to expose.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {boolean=} opt_showFn Also show properties that are functions (by<tr><td><a id="l143"></a><a href="#l143">143</a><td> * default, functions are omitted).<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {string} A string representation of {@code obj}.<tr><td><a id="l145"></a><a href="#l145">145</a><td> */<tr><td><a id="l146"></a><a href="#l146">146</a><td>goog.debug.deepExpose = function(obj, opt_showFn) {<tr><td><a id="l147"></a><a href="#l147">147</a><td> var str = [];<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td> var helper = function(obj, space, parentSeen) {<tr><td><a id="l150"></a><a href="#l150">150</a><td> var nestspace = space + &#39; &#39;;<tr><td><a id="l151"></a><a href="#l151">151</a><td> var seen = new goog.structs.Set(parentSeen);<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td> var indentMultiline = function(str) {<tr><td><a id="l154"></a><a href="#l154">154</a><td> return str.replace(/\n/g, &#39;\n&#39; + space);<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> /** @preserveTry */<tr><td><a id="l158"></a><a href="#l158">158</a><td> try {<tr><td><a id="l159"></a><a href="#l159">159</a><td> if (!goog.isDef(obj)) {<tr><td><a id="l160"></a><a href="#l160">160</a><td> str.push(&#39;undefined&#39;);<tr><td><a id="l161"></a><a href="#l161">161</a><td> } else if (goog.isNull(obj)) {<tr><td><a id="l162"></a><a href="#l162">162</a><td> str.push(&#39;NULL&#39;);<tr><td><a id="l163"></a><a href="#l163">163</a><td> } else if (goog.isString(obj)) {<tr><td><a id="l164"></a><a href="#l164">164</a><td> str.push(&#39;&quot;&#39; + indentMultiline(obj) + &#39;&quot;&#39;);<tr><td><a id="l165"></a><a href="#l165">165</a><td> } else if (goog.isFunction(obj)) {<tr><td><a id="l166"></a><a href="#l166">166</a><td> str.push(indentMultiline(String(obj)));<tr><td><a id="l167"></a><a href="#l167">167</a><td> } else if (goog.isObject(obj)) {<tr><td><a id="l168"></a><a href="#l168">168</a><td> if (seen.contains(obj)) {<tr><td><a id="l169"></a><a href="#l169">169</a><td> str.push(&#39;*** reference loop detected ***&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td> } else {<tr><td><a id="l171"></a><a href="#l171">171</a><td> seen.add(obj);<tr><td><a id="l172"></a><a href="#l172">172</a><td> str.push(&#39;{&#39;);<tr><td><a id="l173"></a><a href="#l173">173</a><td> for (var x in obj) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> if (!opt_showFn &amp;&amp; goog.isFunction(obj[x])) {<tr><td><a id="l175"></a><a href="#l175">175</a><td> continue;<tr><td><a id="l176"></a><a href="#l176">176</a><td> }<tr><td><a id="l177"></a><a href="#l177">177</a><td> str.push(&#39;\n&#39;);<tr><td><a id="l178"></a><a href="#l178">178</a><td> str.push(nestspace);<tr><td><a id="l179"></a><a href="#l179">179</a><td> str.push(x + &#39; = &#39;);<tr><td><a id="l180"></a><a href="#l180">180</a><td> helper(obj[x], nestspace, seen);<tr><td><a id="l181"></a><a href="#l181">181</a><td> }<tr><td><a id="l182"></a><a href="#l182">182</a><td> str.push(&#39;\n&#39; + space + &#39;}&#39;);<tr><td><a id="l183"></a><a href="#l183">183</a><td> }<tr><td><a id="l184"></a><a href="#l184">184</a><td> } else {<tr><td><a id="l185"></a><a href="#l185">185</a><td> str.push(obj);<tr><td><a id="l186"></a><a href="#l186">186</a><td> }<tr><td><a id="l187"></a><a href="#l187">187</a><td> } catch (e) {<tr><td><a id="l188"></a><a href="#l188">188</a><td> str.push(&#39;*** &#39; + e + &#39; ***&#39;);<tr><td><a id="l189"></a><a href="#l189">189</a><td> }<tr><td><a id="l190"></a><a href="#l190">190</a><td> };<tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td> helper(obj, &#39;&#39;, new goog.structs.Set());<tr><td><a id="l193"></a><a href="#l193">193</a><td> return str.join(&#39;&#39;);<tr><td><a id="l194"></a><a href="#l194">194</a><td>};<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Recursively outputs a nested array as a string.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {Array&lt;?&gt;} arr The array.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {string} String representing nested array.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.debug.exposeArray = function(arr) {<tr><td><a id="l203"></a><a href="#l203">203</a><td> var str = [];<tr><td><a id="l204"></a><a href="#l204">204</a><td> for (var i = 0; i &lt; arr.length; i++) {<tr><td><a id="l205"></a><a href="#l205">205</a><td> if (goog.isArray(arr[i])) {<tr><td><a id="l206"></a><a href="#l206">206</a><td> str.push(goog.debug.exposeArray(arr[i]));<tr><td><a id="l207"></a><a href="#l207">207</a><td> } else {<tr><td><a id="l208"></a><a href="#l208">208</a><td> str.push(arr[i]);<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 &#39;[ &#39; + str.join(&#39;, &#39;) + &#39; ]&#39;;<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> * Exposes an exception that has been caught by a try...catch and outputs the<tr><td><a id="l217"></a><a href="#l217">217</a><td> * error as HTML with a stack trace.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @param {Object} err Error object or string.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {Function=} opt_fn Optional function to start stack trace from.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @return {string} Details of exception, as HTML.<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.debug.exposeException = function(err, opt_fn) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> var html = goog.debug.exposeExceptionAsHtml(err, opt_fn);<tr><td><a id="l224"></a><a href="#l224">224</a><td> return goog.html.SafeHtml.unwrap(html);<tr><td><a id="l225"></a><a href="#l225">225</a><td>};<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>/**<tr><td><a id="l229"></a><a href="#l229">229</a><td> * Exposes an exception that has been caught by a try...catch and outputs the<tr><td><a id="l230"></a><a href="#l230">230</a><td> * error with a stack trace.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @param {Object} err Error object or string.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @param {Function=} opt_fn Optional function to start stack trace from.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @return {!goog.html.SafeHtml} Details of exception.<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.debug.exposeExceptionAsHtml = function(err, opt_fn) {<tr><td><a id="l236"></a><a href="#l236">236</a><td> /** @preserveTry */<tr><td><a id="l237"></a><a href="#l237">237</a><td> try {<tr><td><a id="l238"></a><a href="#l238">238</a><td> var e = goog.debug.normalizeErrorObject(err);<tr><td><a id="l239"></a><a href="#l239">239</a><td> // Create the error message<tr><td><a id="l240"></a><a href="#l240">240</a><td> var viewSourceUrl = goog.debug.createViewSourceUrl_(e.fileName);<tr><td><a id="l241"></a><a href="#l241">241</a><td> var error = goog.html.SafeHtml.concat(<tr><td><a id="l242"></a><a href="#l242">242</a><td> goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l243"></a><a href="#l243">243</a><td> &#39;Message: &#39; + e.message + &#39;\nUrl: &#39;),<tr><td><a id="l244"></a><a href="#l244">244</a><td> goog.html.SafeHtml.create(&#39;a&#39;,<tr><td><a id="l245"></a><a href="#l245">245</a><td> {href: viewSourceUrl, target: &#39;_new&#39;}, e.fileName),<tr><td><a id="l246"></a><a href="#l246">246</a><td> goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l247"></a><a href="#l247">247</a><td> &#39;\nLine: &#39; + e.lineNumber + &#39;\n\nBrowser stack:\n&#39; +<tr><td><a id="l248"></a><a href="#l248">248</a><td> e.stack + &#39;-&gt; &#39; + &#39;[end]\n\nJS stack traversal:\n&#39; +<tr><td><a id="l249"></a><a href="#l249">249</a><td> goog.debug.getStacktrace(opt_fn) + &#39;-&gt; &#39;));<tr><td><a id="l250"></a><a href="#l250">250</a><td> return error;<tr><td><a id="l251"></a><a href="#l251">251</a><td> } catch (e2) {<tr><td><a id="l252"></a><a href="#l252">252</a><td> return goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l253"></a><a href="#l253">253</a><td> &#39;Exception trying to expose exception! You win, we lose. &#39; + e2);<tr><td><a id="l254"></a><a href="#l254">254</a><td> }<tr><td><a id="l255"></a><a href="#l255">255</a><td>};<tr><td><a id="l256"></a><a href="#l256">256</a><td><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> * @param {?string=} opt_fileName<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {!goog.html.SafeUrl} SafeUrl with view-source scheme, pointing at<tr><td><a id="l261"></a><a href="#l261">261</a><td> * fileName.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @private<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.debug.createViewSourceUrl_ = function(opt_fileName) {<tr><td><a id="l265"></a><a href="#l265">265</a><td> if (!goog.isDefAndNotNull(opt_fileName)) {<tr><td><a id="l266"></a><a href="#l266">266</a><td> opt_fileName = &#39;&#39;;<tr><td><a id="l267"></a><a href="#l267">267</a><td> }<tr><td><a id="l268"></a><a href="#l268">268</a><td> if (!/^https?:\/\//i.test(opt_fileName)) {<tr><td><a id="l269"></a><a href="#l269">269</a><td> return goog.html.SafeUrl.fromConstant(<tr><td><a id="l270"></a><a href="#l270">270</a><td> goog.string.Const.from(&#39;sanitizedviewsrc&#39;));<tr><td><a id="l271"></a><a href="#l271">271</a><td> }<tr><td><a id="l272"></a><a href="#l272">272</a><td> var sanitizedFileName = goog.html.SafeUrl.sanitize(opt_fileName);<tr><td><a id="l273"></a><a href="#l273">273</a><td> return goog.html.uncheckedconversions.<tr><td><a id="l274"></a><a href="#l274">274</a><td> safeUrlFromStringKnownToSatisfyTypeContract(<tr><td><a id="l275"></a><a href="#l275">275</a><td> goog.string.Const.from(&#39;view-source scheme plus HTTP/HTTPS URL&#39;),<tr><td><a id="l276"></a><a href="#l276">276</a><td> &#39;view-source:&#39; + goog.html.SafeUrl.unwrap(sanitizedFileName));<tr><td><a id="l277"></a><a href="#l277">277</a><td>};<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>/**<tr><td><a id="l281"></a><a href="#l281">281</a><td> * Normalizes the error/exception object between browsers.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {Object} err Raw error object.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @return {!Object} Normalized error object.<tr><td><a id="l284"></a><a href="#l284">284</a><td> */<tr><td><a id="l285"></a><a href="#l285">285</a><td>goog.debug.normalizeErrorObject = function(err) {<tr><td><a id="l286"></a><a href="#l286">286</a><td> var href = goog.getObjectByName(&#39;window.location.href&#39;);<tr><td><a id="l287"></a><a href="#l287">287</a><td> if (goog.isString(err)) {<tr><td><a id="l288"></a><a href="#l288">288</a><td> return {<tr><td><a id="l289"></a><a href="#l289">289</a><td> &#39;message&#39;: err,<tr><td><a id="l290"></a><a href="#l290">290</a><td> &#39;name&#39;: &#39;Unknown error&#39;,<tr><td><a id="l291"></a><a href="#l291">291</a><td> &#39;lineNumber&#39;: &#39;Not available&#39;,<tr><td><a id="l292"></a><a href="#l292">292</a><td> &#39;fileName&#39;: href,<tr><td><a id="l293"></a><a href="#l293">293</a><td> &#39;stack&#39;: &#39;Not available&#39;<tr><td><a id="l294"></a><a href="#l294">294</a><td> };<tr><td><a id="l295"></a><a href="#l295">295</a><td> }<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td> var lineNumber, fileName;<tr><td><a id="l298"></a><a href="#l298">298</a><td> var threwError = false;<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td> try {<tr><td><a id="l301"></a><a href="#l301">301</a><td> lineNumber = err.lineNumber || err.line || &#39;Not available&#39;;<tr><td><a id="l302"></a><a href="#l302">302</a><td> } catch (e) {<tr><td><a id="l303"></a><a href="#l303">303</a><td> // Firefox 2 sometimes throws an error when accessing &#39;lineNumber&#39;:<tr><td><a id="l304"></a><a href="#l304">304</a><td> // Message: Permission denied to get property UnnamedClass.lineNumber<tr><td><a id="l305"></a><a href="#l305">305</a><td> lineNumber = &#39;Not available&#39;;<tr><td><a id="l306"></a><a href="#l306">306</a><td> threwError = true;<tr><td><a id="l307"></a><a href="#l307">307</a><td> }<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td> try {<tr><td><a id="l310"></a><a href="#l310">310</a><td> fileName = err.fileName || err.filename || err.sourceURL ||<tr><td><a id="l311"></a><a href="#l311">311</a><td> // $googDebugFname may be set before a call to eval to set the filename<tr><td><a id="l312"></a><a href="#l312">312</a><td> // that the eval is supposed to present.<tr><td><a id="l313"></a><a href="#l313">313</a><td> goog.global[&#39;$googDebugFname&#39;] || href;<tr><td><a id="l314"></a><a href="#l314">314</a><td> } catch (e) {<tr><td><a id="l315"></a><a href="#l315">315</a><td> // Firefox 2 may also throw an error when accessing &#39;filename&#39;.<tr><td><a id="l316"></a><a href="#l316">316</a><td> fileName = &#39;Not available&#39;;<tr><td><a id="l317"></a><a href="#l317">317</a><td> threwError = true;<tr><td><a id="l318"></a><a href="#l318">318</a><td> }<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td> // The IE Error object contains only the name and the message.<tr><td><a id="l321"></a><a href="#l321">321</a><td> // The Safari Error object uses the line and sourceURL fields.<tr><td><a id="l322"></a><a href="#l322">322</a><td> if (threwError || !err.lineNumber || !err.fileName || !err.stack ||<tr><td><a id="l323"></a><a href="#l323">323</a><td> !err.message || !err.name) {<tr><td><a id="l324"></a><a href="#l324">324</a><td> return {<tr><td><a id="l325"></a><a href="#l325">325</a><td> &#39;message&#39;: err.message || &#39;Not available&#39;,<tr><td><a id="l326"></a><a href="#l326">326</a><td> &#39;name&#39;: err.name || &#39;UnknownError&#39;,<tr><td><a id="l327"></a><a href="#l327">327</a><td> &#39;lineNumber&#39;: lineNumber,<tr><td><a id="l328"></a><a href="#l328">328</a><td> &#39;fileName&#39;: fileName,<tr><td><a id="l329"></a><a href="#l329">329</a><td> &#39;stack&#39;: err.stack || &#39;Not available&#39;<tr><td><a id="l330"></a><a href="#l330">330</a><td> };<tr><td><a id="l331"></a><a href="#l331">331</a><td> }<tr><td><a id="l332"></a><a href="#l332">332</a><td><tr><td><a id="l333"></a><a href="#l333">333</a><td> // Standards error object<tr><td><a id="l334"></a><a href="#l334">334</a><td> return err;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><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> * Converts an object to an Error if it&#39;s a String,<tr><td><a id="l340"></a><a href="#l340">340</a><td> * adds a stacktrace if there isn&#39;t one,<tr><td><a id="l341"></a><a href="#l341">341</a><td> * and optionally adds an extra message.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {Error|string} err the original thrown object or string.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @param {string=} opt_message optional additional message to add to the<tr><td><a id="l344"></a><a href="#l344">344</a><td> * error.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return {!Error} If err is a string, it is used to create a new Error,<tr><td><a id="l346"></a><a href="#l346">346</a><td> * which is enhanced and returned. Otherwise err itself is enhanced<tr><td><a id="l347"></a><a href="#l347">347</a><td> * and returned.<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>goog.debug.enhanceError = function(err, opt_message) {<tr><td><a id="l350"></a><a href="#l350">350</a><td> var error;<tr><td><a id="l351"></a><a href="#l351">351</a><td> if (typeof err == &#39;string&#39;) {<tr><td><a id="l352"></a><a href="#l352">352</a><td> error = Error(err);<tr><td><a id="l353"></a><a href="#l353">353</a><td> if (Error.captureStackTrace) {<tr><td><a id="l354"></a><a href="#l354">354</a><td> // Trim this function off the call stack, if we can.<tr><td><a id="l355"></a><a href="#l355">355</a><td> Error.captureStackTrace(error, goog.debug.enhanceError);<tr><td><a id="l356"></a><a href="#l356">356</a><td> }<tr><td><a id="l357"></a><a href="#l357">357</a><td> } else {<tr><td><a id="l358"></a><a href="#l358">358</a><td> error = err;<tr><td><a id="l359"></a><a href="#l359">359</a><td> }<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td> if (!error.stack) {<tr><td><a id="l362"></a><a href="#l362">362</a><td> error.stack = goog.debug.getStacktrace(goog.debug.enhanceError);<tr><td><a id="l363"></a><a href="#l363">363</a><td> }<tr><td><a id="l364"></a><a href="#l364">364</a><td> if (opt_message) {<tr><td><a id="l365"></a><a href="#l365">365</a><td> // find the first unoccupied &#39;messageX&#39; property<tr><td><a id="l366"></a><a href="#l366">366</a><td> var x = 0;<tr><td><a id="l367"></a><a href="#l367">367</a><td> while (error[&#39;message&#39; + x]) {<tr><td><a id="l368"></a><a href="#l368">368</a><td> ++x;<tr><td><a id="l369"></a><a href="#l369">369</a><td> }<tr><td><a id="l370"></a><a href="#l370">370</a><td> error[&#39;message&#39; + x] = String(opt_message);<tr><td><a id="l371"></a><a href="#l371">371</a><td> }<tr><td><a id="l372"></a><a href="#l372">372</a><td> return error;<tr><td><a id="l373"></a><a href="#l373">373</a><td>};<tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Gets the current stack trace. Simple and iterative - doesn&#39;t worry about<tr><td><a id="l378"></a><a href="#l378">378</a><td> * catching circular references or getting the args.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @param {number=} opt_depth Optional maximum depth to trace back to.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @return {string} A string with the function names of all functions in the<tr><td><a id="l381"></a><a href="#l381">381</a><td> * stack, separated by \n.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @suppress {es5Strict}<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>goog.debug.getStacktraceSimple = function(opt_depth) {<tr><td><a id="l385"></a><a href="#l385">385</a><td> if (goog.STRICT_MODE_COMPATIBLE) {<tr><td><a id="l386"></a><a href="#l386">386</a><td> var stack = goog.debug.getNativeStackTrace_(goog.debug.getStacktraceSimple);<tr><td><a id="l387"></a><a href="#l387">387</a><td> if (stack) {<tr><td><a id="l388"></a><a href="#l388">388</a><td> return stack;<tr><td><a id="l389"></a><a href="#l389">389</a><td> }<tr><td><a id="l390"></a><a href="#l390">390</a><td> // NOTE: browsers that have strict mode support also have native &quot;stack&quot;<tr><td><a id="l391"></a><a href="#l391">391</a><td> // properties. Fall-through for legacy browser support.<tr><td><a id="l392"></a><a href="#l392">392</a><td> }<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td> var sb = [];<tr><td><a id="l395"></a><a href="#l395">395</a><td> var fn = arguments.callee.caller;<tr><td><a id="l396"></a><a href="#l396">396</a><td> var depth = 0;<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td> while (fn &amp;&amp; (!opt_depth || depth &lt; opt_depth)) {<tr><td><a id="l399"></a><a href="#l399">399</a><td> sb.push(goog.debug.getFunctionName(fn));<tr><td><a id="l400"></a><a href="#l400">400</a><td> sb.push(&#39;()\n&#39;);<tr><td><a id="l401"></a><a href="#l401">401</a><td> /** @preserveTry */<tr><td><a id="l402"></a><a href="#l402">402</a><td> try {<tr><td><a id="l403"></a><a href="#l403">403</a><td> fn = fn.caller;<tr><td><a id="l404"></a><a href="#l404">404</a><td> } catch (e) {<tr><td><a id="l405"></a><a href="#l405">405</a><td> sb.push(&#39;[exception trying to get caller]\n&#39;);<tr><td><a id="l406"></a><a href="#l406">406</a><td> break;<tr><td><a id="l407"></a><a href="#l407">407</a><td> }<tr><td><a id="l408"></a><a href="#l408">408</a><td> depth++;<tr><td><a id="l409"></a><a href="#l409">409</a><td> if (depth &gt;= goog.debug.MAX_STACK_DEPTH) {<tr><td><a id="l410"></a><a href="#l410">410</a><td> sb.push(&#39;[...long stack...]&#39;);<tr><td><a id="l411"></a><a href="#l411">411</a><td> break;<tr><td><a id="l412"></a><a href="#l412">412</a><td> }<tr><td><a id="l413"></a><a href="#l413">413</a><td> }<tr><td><a id="l414"></a><a href="#l414">414</a><td> if (opt_depth &amp;&amp; depth &gt;= opt_depth) {<tr><td><a id="l415"></a><a href="#l415">415</a><td> sb.push(&#39;[...reached max depth limit...]&#39;);<tr><td><a id="l416"></a><a href="#l416">416</a><td> } else {<tr><td><a id="l417"></a><a href="#l417">417</a><td> sb.push(&#39;[end]&#39;);<tr><td><a id="l418"></a><a href="#l418">418</a><td> }<tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td> return sb.join(&#39;&#39;);<tr><td><a id="l421"></a><a href="#l421">421</a><td>};<tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td>/**<tr><td><a id="l425"></a><a href="#l425">425</a><td> * Max length of stack to try and output<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @type {number}<tr><td><a id="l427"></a><a href="#l427">427</a><td> */<tr><td><a id="l428"></a><a href="#l428">428</a><td>goog.debug.MAX_STACK_DEPTH = 50;<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @param {Function} fn The function to start getting the trace from.<tr><td><a id="l433"></a><a href="#l433">433</a><td> * @return {?string}<tr><td><a id="l434"></a><a href="#l434">434</a><td> * @private<tr><td><a id="l435"></a><a href="#l435">435</a><td> */<tr><td><a id="l436"></a><a href="#l436">436</a><td>goog.debug.getNativeStackTrace_ = function(fn) {<tr><td><a id="l437"></a><a href="#l437">437</a><td> var tempErr = new Error();<tr><td><a id="l438"></a><a href="#l438">438</a><td> if (Error.captureStackTrace) {<tr><td><a id="l439"></a><a href="#l439">439</a><td> Error.captureStackTrace(tempErr, fn);<tr><td><a id="l440"></a><a href="#l440">440</a><td> return String(tempErr.stack);<tr><td><a id="l441"></a><a href="#l441">441</a><td> } else {<tr><td><a id="l442"></a><a href="#l442">442</a><td> // IE10, only adds stack traces when an exception is thrown.<tr><td><a id="l443"></a><a href="#l443">443</a><td> try {<tr><td><a id="l444"></a><a href="#l444">444</a><td> throw tempErr;<tr><td><a id="l445"></a><a href="#l445">445</a><td> } catch (e) {<tr><td><a id="l446"></a><a href="#l446">446</a><td> tempErr = e;<tr><td><a id="l447"></a><a href="#l447">447</a><td> }<tr><td><a id="l448"></a><a href="#l448">448</a><td> var stack = tempErr.stack;<tr><td><a id="l449"></a><a href="#l449">449</a><td> if (stack) {<tr><td><a id="l450"></a><a href="#l450">450</a><td> return String(stack);<tr><td><a id="l451"></a><a href="#l451">451</a><td> }<tr><td><a id="l452"></a><a href="#l452">452</a><td> }<tr><td><a id="l453"></a><a href="#l453">453</a><td> return null;<tr><td><a id="l454"></a><a href="#l454">454</a><td>};<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>/**<tr><td><a id="l458"></a><a href="#l458">458</a><td> * Gets the current stack trace, either starting from the caller or starting<tr><td><a id="l459"></a><a href="#l459">459</a><td> * from a specified function that&#39;s currently on the call stack.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {Function=} opt_fn Optional function to start getting the trace from.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * If not provided, defaults to the function that called this.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {string} Stack trace.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @suppress {es5Strict}<tr><td><a id="l464"></a><a href="#l464">464</a><td> */<tr><td><a id="l465"></a><a href="#l465">465</a><td>goog.debug.getStacktrace = function(opt_fn) {<tr><td><a id="l466"></a><a href="#l466">466</a><td> var stack;<tr><td><a id="l467"></a><a href="#l467">467</a><td> if (goog.STRICT_MODE_COMPATIBLE) {<tr><td><a id="l468"></a><a href="#l468">468</a><td> // Try to get the stack trace from the environment if it is available.<tr><td><a id="l469"></a><a href="#l469">469</a><td> var contextFn = opt_fn || goog.debug.getStacktrace;<tr><td><a id="l470"></a><a href="#l470">470</a><td> stack = goog.debug.getNativeStackTrace_(contextFn);<tr><td><a id="l471"></a><a href="#l471">471</a><td> }<tr><td><a id="l472"></a><a href="#l472">472</a><td> if (!stack) {<tr><td><a id="l473"></a><a href="#l473">473</a><td> // NOTE: browsers that have strict mode support also have native &quot;stack&quot;<tr><td><a id="l474"></a><a href="#l474">474</a><td> // properties. This function will throw in strict mode.<tr><td><a id="l475"></a><a href="#l475">475</a><td> stack = goog.debug.getStacktraceHelper_(<tr><td><a id="l476"></a><a href="#l476">476</a><td> opt_fn || arguments.callee.caller, []);<tr><td><a id="l477"></a><a href="#l477">477</a><td> }<tr><td><a id="l478"></a><a href="#l478">478</a><td> return stack;<tr><td><a id="l479"></a><a href="#l479">479</a><td>};<tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>/**<tr><td><a id="l483"></a><a href="#l483">483</a><td> * Private helper for getStacktrace().<tr><td><a id="l484"></a><a href="#l484">484</a><td> * @param {Function} fn Function to start getting the trace from.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @param {Array&lt;!Function&gt;} visited List of functions visited so far.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @return {string} Stack trace starting from function fn.<tr><td><a id="l487"></a><a href="#l487">487</a><td> * @suppress {es5Strict}<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @private<tr><td><a id="l489"></a><a href="#l489">489</a><td> */<tr><td><a id="l490"></a><a href="#l490">490</a><td>goog.debug.getStacktraceHelper_ = function(fn, visited) {<tr><td><a id="l491"></a><a href="#l491">491</a><td> var sb = [];<tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td> // Circular reference, certain functions like bind seem to cause a recursive<tr><td><a id="l494"></a><a href="#l494">494</a><td> // loop so we need to catch circular references<tr><td><a id="l495"></a><a href="#l495">495</a><td> if (goog.array.contains(visited, fn)) {<tr><td><a id="l496"></a><a href="#l496">496</a><td> sb.push(&#39;[...circular reference...]&#39;);<tr><td><a id="l497"></a><a href="#l497">497</a><td><tr><td><a id="l498"></a><a href="#l498">498</a><td> // Traverse the call stack until function not found or max depth is reached<tr><td><a id="l499"></a><a href="#l499">499</a><td> } else if (fn &amp;&amp; visited.length &lt; goog.debug.MAX_STACK_DEPTH) {<tr><td><a id="l500"></a><a href="#l500">500</a><td> sb.push(goog.debug.getFunctionName(fn) + &#39;(&#39;);<tr><td><a id="l501"></a><a href="#l501">501</a><td> var args = fn.arguments;<tr><td><a id="l502"></a><a href="#l502">502</a><td> // Args may be null for some special functions such as host objects or eval.<tr><td><a id="l503"></a><a href="#l503">503</a><td> for (var i = 0; args &amp;&amp; i &lt; args.length; i++) {<tr><td><a id="l504"></a><a href="#l504">504</a><td> if (i &gt; 0) {<tr><td><a id="l505"></a><a href="#l505">505</a><td> sb.push(&#39;, &#39;);<tr><td><a id="l506"></a><a href="#l506">506</a><td> }<tr><td><a id="l507"></a><a href="#l507">507</a><td> var argDesc;<tr><td><a id="l508"></a><a href="#l508">508</a><td> var arg = args[i];<tr><td><a id="l509"></a><a href="#l509">509</a><td> switch (typeof arg) {<tr><td><a id="l510"></a><a href="#l510">510</a><td> case &#39;object&#39;:<tr><td><a id="l511"></a><a href="#l511">511</a><td> argDesc = arg ? &#39;object&#39; : &#39;null&#39;;<tr><td><a id="l512"></a><a href="#l512">512</a><td> break;<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td> case &#39;string&#39;:<tr><td><a id="l515"></a><a href="#l515">515</a><td> argDesc = arg;<tr><td><a id="l516"></a><a href="#l516">516</a><td> break;<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td> case &#39;number&#39;:<tr><td><a id="l519"></a><a href="#l519">519</a><td> argDesc = String(arg);<tr><td><a id="l520"></a><a href="#l520">520</a><td> break;<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td> case &#39;boolean&#39;:<tr><td><a id="l523"></a><a href="#l523">523</a><td> argDesc = arg ? &#39;true&#39; : &#39;false&#39;;<tr><td><a id="l524"></a><a href="#l524">524</a><td> break;<tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td> case &#39;function&#39;:<tr><td><a id="l527"></a><a href="#l527">527</a><td> argDesc = goog.debug.getFunctionName(arg);<tr><td><a id="l528"></a><a href="#l528">528</a><td> argDesc = argDesc ? argDesc : &#39;[fn]&#39;;<tr><td><a id="l529"></a><a href="#l529">529</a><td> break;<tr><td><a id="l530"></a><a href="#l530">530</a><td><tr><td><a id="l531"></a><a href="#l531">531</a><td> case &#39;undefined&#39;:<tr><td><a id="l532"></a><a href="#l532">532</a><td> default:<tr><td><a id="l533"></a><a href="#l533">533</a><td> argDesc = typeof arg;<tr><td><a id="l534"></a><a href="#l534">534</a><td> break;<tr><td><a id="l535"></a><a href="#l535">535</a><td> }<tr><td><a id="l536"></a><a href="#l536">536</a><td><tr><td><a id="l537"></a><a href="#l537">537</a><td> if (argDesc.length &gt; 40) {<tr><td><a id="l538"></a><a href="#l538">538</a><td> argDesc = argDesc.substr(0, 40) + &#39;...&#39;;<tr><td><a id="l539"></a><a href="#l539">539</a><td> }<tr><td><a id="l540"></a><a href="#l540">540</a><td> sb.push(argDesc);<tr><td><a id="l541"></a><a href="#l541">541</a><td> }<tr><td><a id="l542"></a><a href="#l542">542</a><td> visited.push(fn);<tr><td><a id="l543"></a><a href="#l543">543</a><td> sb.push(&#39;)\n&#39;);<tr><td><a id="l544"></a><a href="#l544">544</a><td> /** @preserveTry */<tr><td><a id="l545"></a><a href="#l545">545</a><td> try {<tr><td><a id="l546"></a><a href="#l546">546</a><td> sb.push(goog.debug.getStacktraceHelper_(fn.caller, visited));<tr><td><a id="l547"></a><a href="#l547">547</a><td> } catch (e) {<tr><td><a id="l548"></a><a href="#l548">548</a><td> sb.push(&#39;[exception trying to get caller]\n&#39;);<tr><td><a id="l549"></a><a href="#l549">549</a><td> }<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td> } else if (fn) {<tr><td><a id="l552"></a><a href="#l552">552</a><td> sb.push(&#39;[...long stack...]&#39;);<tr><td><a id="l553"></a><a href="#l553">553</a><td> } else {<tr><td><a id="l554"></a><a href="#l554">554</a><td> sb.push(&#39;[end]&#39;);<tr><td><a id="l555"></a><a href="#l555">555</a><td> }<tr><td><a id="l556"></a><a href="#l556">556</a><td> return sb.join(&#39;&#39;);<tr><td><a id="l557"></a><a href="#l557">557</a><td>};<tr><td><a id="l558"></a><a href="#l558">558</a><td><tr><td><a id="l559"></a><a href="#l559">559</a><td><tr><td><a id="l560"></a><a href="#l560">560</a><td>/**<tr><td><a id="l561"></a><a href="#l561">561</a><td> * Set a custom function name resolver.<tr><td><a id="l562"></a><a href="#l562">562</a><td> * @param {function(Function): string} resolver Resolves functions to their<tr><td><a id="l563"></a><a href="#l563">563</a><td> * names.<tr><td><a id="l564"></a><a href="#l564">564</a><td> */<tr><td><a id="l565"></a><a href="#l565">565</a><td>goog.debug.setFunctionResolver = function(resolver) {<tr><td><a id="l566"></a><a href="#l566">566</a><td> goog.debug.fnNameResolver_ = resolver;<tr><td><a id="l567"></a><a href="#l567">567</a><td>};<tr><td><a id="l568"></a><a href="#l568">568</a><td><tr><td><a id="l569"></a><a href="#l569">569</a><td><tr><td><a id="l570"></a><a href="#l570">570</a><td>/**<tr><td><a id="l571"></a><a href="#l571">571</a><td> * Gets a function name<tr><td><a id="l572"></a><a href="#l572">572</a><td> * @param {Function} fn Function to get name of.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @return {string} Function&#39;s name.<tr><td><a id="l574"></a><a href="#l574">574</a><td> */<tr><td><a id="l575"></a><a href="#l575">575</a><td>goog.debug.getFunctionName = function(fn) {<tr><td><a id="l576"></a><a href="#l576">576</a><td> if (goog.debug.fnNameCache_[fn]) {<tr><td><a id="l577"></a><a href="#l577">577</a><td> return goog.debug.fnNameCache_[fn];<tr><td><a id="l578"></a><a href="#l578">578</a><td> }<tr><td><a id="l579"></a><a href="#l579">579</a><td> if (goog.debug.fnNameResolver_) {<tr><td><a id="l580"></a><a href="#l580">580</a><td> var name = goog.debug.fnNameResolver_(fn);<tr><td><a id="l581"></a><a href="#l581">581</a><td> if (name) {<tr><td><a id="l582"></a><a href="#l582">582</a><td> goog.debug.fnNameCache_[fn] = name;<tr><td><a id="l583"></a><a href="#l583">583</a><td> return name;<tr><td><a id="l584"></a><a href="#l584">584</a><td> }<tr><td><a id="l585"></a><a href="#l585">585</a><td> }<tr><td><a id="l586"></a><a href="#l586">586</a><td><tr><td><a id="l587"></a><a href="#l587">587</a><td> // Heuristically determine function name based on code.<tr><td><a id="l588"></a><a href="#l588">588</a><td> var functionSource = String(fn);<tr><td><a id="l589"></a><a href="#l589">589</a><td> if (!goog.debug.fnNameCache_[functionSource]) {<tr><td><a id="l590"></a><a href="#l590">590</a><td> var matches = /function ([^\(]+)/.exec(functionSource);<tr><td><a id="l591"></a><a href="#l591">591</a><td> if (matches) {<tr><td><a id="l592"></a><a href="#l592">592</a><td> var method = matches[1];<tr><td><a id="l593"></a><a href="#l593">593</a><td> goog.debug.fnNameCache_[functionSource] = method;<tr><td><a id="l594"></a><a href="#l594">594</a><td> } else {<tr><td><a id="l595"></a><a href="#l595">595</a><td> goog.debug.fnNameCache_[functionSource] = &#39;[Anonymous]&#39;;<tr><td><a id="l596"></a><a href="#l596">596</a><td> }<tr><td><a id="l597"></a><a href="#l597">597</a><td> }<tr><td><a id="l598"></a><a href="#l598">598</a><td><tr><td><a id="l599"></a><a href="#l599">599</a><td> return goog.debug.fnNameCache_[functionSource];<tr><td><a id="l600"></a><a href="#l600">600</a><td>};<tr><td><a id="l601"></a><a href="#l601">601</a><td><tr><td><a id="l602"></a><a href="#l602">602</a><td><tr><td><a id="l603"></a><a href="#l603">603</a><td>/**<tr><td><a id="l604"></a><a href="#l604">604</a><td> * Makes whitespace visible by replacing it with printable characters.<tr><td><a id="l605"></a><a href="#l605">605</a><td> * This is useful in finding diffrences between the expected and the actual<tr><td><a id="l606"></a><a href="#l606">606</a><td> * output strings of a testcase.<tr><td><a id="l607"></a><a href="#l607">607</a><td> * @param {string} string whose whitespace needs to be made visible.<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @return {string} string whose whitespace is made visible.<tr><td><a id="l609"></a><a href="#l609">609</a><td> */<tr><td><a id="l610"></a><a href="#l610">610</a><td>goog.debug.makeWhitespaceVisible = function(string) {<tr><td><a id="l611"></a><a href="#l611">611</a><td> return string.replace(/ /g, &#39;[_]&#39;)<tr><td><a id="l612"></a><a href="#l612">612</a><td> .replace(/\f/g, &#39;[f]&#39;)<tr><td><a id="l613"></a><a href="#l613">613</a><td> .replace(/\n/g, &#39;[n]\n&#39;)<tr><td><a id="l614"></a><a href="#l614">614</a><td> .replace(/\r/g, &#39;[r]&#39;)<tr><td><a id="l615"></a><a href="#l615">615</a><td> .replace(/\t/g, &#39;[t]&#39;);<tr><td><a id="l616"></a><a href="#l616">616</a><td>};<tr><td><a id="l617"></a><a href="#l617">617</a><td><tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td>/**<tr><td><a id="l620"></a><a href="#l620">620</a><td> * Returns the type of a value. If a constructor is passed, and a suitable<tr><td><a id="l621"></a><a href="#l621">621</a><td> * string cannot be found, &#39;unknown type name&#39; will be returned.<tr><td><a id="l622"></a><a href="#l622">622</a><td> *<tr><td><a id="l623"></a><a href="#l623">623</a><td> * &lt;p&gt;Forked rather than moved from {@link goog.asserts.getType_}<tr><td><a id="l624"></a><a href="#l624">624</a><td> * to avoid adding a dependency to goog.asserts.<tr><td><a id="l625"></a><a href="#l625">625</a><td> * @param {*} value A constructor, object, or primitive.<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @return {string} The best display name for the value, or &#39;unknown type name&#39;.<tr><td><a id="l627"></a><a href="#l627">627</a><td> */<tr><td><a id="l628"></a><a href="#l628">628</a><td>goog.debug.runtimeType = function(value) {<tr><td><a id="l629"></a><a href="#l629">629</a><td> if (value instanceof Function) {<tr><td><a id="l630"></a><a href="#l630">630</a><td> return value.displayName || value.name || &#39;unknown type name&#39;;<tr><td><a id="l631"></a><a href="#l631">631</a><td> } else if (value instanceof Object) {<tr><td><a id="l632"></a><a href="#l632">632</a><td> return value.constructor.displayName || value.constructor.name ||<tr><td><a id="l633"></a><a href="#l633">633</a><td> Object.prototype.toString.call(value);<tr><td><a id="l634"></a><a href="#l634">634</a><td> } else {<tr><td><a id="l635"></a><a href="#l635">635</a><td> return value === null ? &#39;null&#39; : typeof value;<tr><td><a id="l636"></a><a href="#l636">636</a><td> }<tr><td><a id="l637"></a><a href="#l637">637</a><td>};<tr><td><a id="l638"></a><a href="#l638">638</a><td><tr><td><a id="l639"></a><a href="#l639">639</a><td><tr><td><a id="l640"></a><a href="#l640">640</a><td>/**<tr><td><a id="l641"></a><a href="#l641">641</a><td> * Hash map for storing function names that have already been looked up.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @type {Object}<tr><td><a id="l643"></a><a href="#l643">643</a><td> * @private<tr><td><a id="l644"></a><a href="#l644">644</a><td> */<tr><td><a id="l645"></a><a href="#l645">645</a><td>goog.debug.fnNameCache_ = {};<tr><td><a id="l646"></a><a href="#l646">646</a><td><tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td>/**<tr><td><a id="l649"></a><a href="#l649">649</a><td> * Resolves functions to their names. Resolved function names will be cached.<tr><td><a id="l650"></a><a href="#l650">650</a><td> * @type {function(Function):string}<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @private<tr><td><a id="l652"></a><a href="#l652">652</a><td> */<tr><td><a id="l653"></a><a href="#l653">653</a><td>goog.debug.fnNameResolver_;</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/debug/entrypointregistry.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>entrypointregistry.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/debug/entrypointregistry.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 A global registry for entry points into a program,<tr><td><a id="l17"></a><a href="#l17">17</a><td> * so that they can be instrumented. Each module should register their<tr><td><a id="l18"></a><a href="#l18">18</a><td> * entry points with this registry. Designed to be compiled out<tr><td><a id="l19"></a><a href="#l19">19</a><td> * if no instrumentation is requested.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Entry points may be registered before or after a call to<tr><td><a id="l22"></a><a href="#l22">22</a><td> * goog.debug.entryPointRegistry.monitorAll. If an entry point is registered<tr><td><a id="l23"></a><a href="#l23">23</a><td> * later, the existing monitor will instrument the new entry point.<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @author nicksantos@google.com (Nick Santos)<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>goog.provide(&#39;goog.debug.EntryPointMonitor&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.provide(&#39;goog.debug.entryPointRegistry&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @interface<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.debug.EntryPointMonitor = function() {};<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> * Instruments a function.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {!Function} fn A function to instrument.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @return {!Function} The instrumented function.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.debug.EntryPointMonitor.prototype.wrap;<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>/**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * Try to remove an instrumentation wrapper created by this monitor.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * If the function passed to unwrap is not a wrapper created by this<tr><td><a id="l53"></a><a href="#l53">53</a><td> * monitor, then we will do nothing.<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Notice that some wrappers may not be unwrappable. For example, if other<tr><td><a id="l56"></a><a href="#l56">56</a><td> * monitors have applied their own wrappers, then it will be impossible to<tr><td><a id="l57"></a><a href="#l57">57</a><td> * unwrap them because their wrappers will have captured our wrapper.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * So it is important that entry points are unwrapped in the reverse<tr><td><a id="l60"></a><a href="#l60">60</a><td> * order that they were wrapped.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {!Function} fn A function to unwrap.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {!Function} The unwrapped function, or {@code fn} if it was not<tr><td><a id="l64"></a><a href="#l64">64</a><td> * a wrapped function created by this monitor.<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.debug.EntryPointMonitor.prototype.unwrap;<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> * An array of entry point callbacks.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @type {!Array&lt;function(!Function)&gt;}<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @private<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.debug.entryPointRegistry.refList_ = [];<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> * Monitors that should wrap all the entry points.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @type {!Array&lt;!goog.debug.EntryPointMonitor&gt;}<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.debug.entryPointRegistry.monitors_ = [];<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Whether goog.debug.entryPointRegistry.monitorAll has ever been called.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Checking this allows the compiler to optimize out the registrations.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @type {boolean}<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @private<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>goog.debug.entryPointRegistry.monitorsMayExist_ = false;<tr><td><a id="l92"></a><a href="#l92">92</a><td><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> * Register an entry point with this module.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * The entry point will be instrumented when a monitor is passed to<tr><td><a id="l98"></a><a href="#l98">98</a><td> * goog.debug.entryPointRegistry.monitorAll. If this has already occurred, the<tr><td><a id="l99"></a><a href="#l99">99</a><td> * entry point is instrumented immediately.<tr><td><a id="l100"></a><a href="#l100">100</a><td> *<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {function(!Function)} callback A callback function which is called<tr><td><a id="l102"></a><a href="#l102">102</a><td> * with a transforming function to instrument the entry point. The callback<tr><td><a id="l103"></a><a href="#l103">103</a><td> * is responsible for wrapping the relevant entry point with the<tr><td><a id="l104"></a><a href="#l104">104</a><td> * transforming function.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.debug.entryPointRegistry.register = function(callback) {<tr><td><a id="l107"></a><a href="#l107">107</a><td> // Don&#39;t use push(), so that this can be compiled out.<tr><td><a id="l108"></a><a href="#l108">108</a><td> goog.debug.entryPointRegistry.refList_[<tr><td><a id="l109"></a><a href="#l109">109</a><td> goog.debug.entryPointRegistry.refList_.length] = callback;<tr><td><a id="l110"></a><a href="#l110">110</a><td> // If no one calls monitorAll, this can be compiled out.<tr><td><a id="l111"></a><a href="#l111">111</a><td> if (goog.debug.entryPointRegistry.monitorsMayExist_) {<tr><td><a id="l112"></a><a href="#l112">112</a><td> var monitors = goog.debug.entryPointRegistry.monitors_;<tr><td><a id="l113"></a><a href="#l113">113</a><td> for (var i = 0; i &lt; monitors.length; i++) {<tr><td><a id="l114"></a><a href="#l114">114</a><td> callback(goog.bind(monitors[i].wrap, monitors[i]));<tr><td><a id="l115"></a><a href="#l115">115</a><td> }<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td>};<tr><td><a id="l118"></a><a href="#l118">118</a><td><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> * Configures a monitor to wrap all entry points.<tr><td><a id="l122"></a><a href="#l122">122</a><td> *<tr><td><a id="l123"></a><a href="#l123">123</a><td> * Entry points that have already been registered are immediately wrapped by<tr><td><a id="l124"></a><a href="#l124">124</a><td> * the monitor. When an entry point is registered in the future, it will also<tr><td><a id="l125"></a><a href="#l125">125</a><td> * be wrapped by the monitor when it is registered.<tr><td><a id="l126"></a><a href="#l126">126</a><td> *<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {!goog.debug.EntryPointMonitor} monitor An entry point monitor.<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.debug.entryPointRegistry.monitorAll = function(monitor) {<tr><td><a id="l130"></a><a href="#l130">130</a><td> goog.debug.entryPointRegistry.monitorsMayExist_ = true;<tr><td><a id="l131"></a><a href="#l131">131</a><td> var transformer = goog.bind(monitor.wrap, monitor);<tr><td><a id="l132"></a><a href="#l132">132</a><td> for (var i = 0; i &lt; goog.debug.entryPointRegistry.refList_.length; i++) {<tr><td><a id="l133"></a><a href="#l133">133</a><td> goog.debug.entryPointRegistry.refList_[i](transformer);<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.debug.entryPointRegistry.monitors_.push(monitor);<tr><td><a id="l136"></a><a href="#l136">136</a><td>};<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> * Try to unmonitor all the entry points that have already been registered. If<tr><td><a id="l141"></a><a href="#l141">141</a><td> * an entry point is registered in the future, it will not be wrapped by the<tr><td><a id="l142"></a><a href="#l142">142</a><td> * monitor when it is registered. Note that this may fail if the entry points<tr><td><a id="l143"></a><a href="#l143">143</a><td> * have additional wrapping.<tr><td><a id="l144"></a><a href="#l144">144</a><td> *<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {!goog.debug.EntryPointMonitor} monitor The last monitor to wrap<tr><td><a id="l146"></a><a href="#l146">146</a><td> * the entry points.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @throws {Error} If the monitor is not the most recently configured monitor.<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>goog.debug.entryPointRegistry.unmonitorAllIfPossible = function(monitor) {<tr><td><a id="l150"></a><a href="#l150">150</a><td> var monitors = goog.debug.entryPointRegistry.monitors_;<tr><td><a id="l151"></a><a href="#l151">151</a><td> goog.asserts.assert(monitor == monitors[monitors.length - 1],<tr><td><a id="l152"></a><a href="#l152">152</a><td> &#39;Only the most recent monitor can be unwrapped.&#39;);<tr><td><a id="l153"></a><a href="#l153">153</a><td> var transformer = goog.bind(monitor.unwrap, monitor);<tr><td><a id="l154"></a><a href="#l154">154</a><td> for (var i = 0; i &lt; goog.debug.entryPointRegistry.refList_.length; i++) {<tr><td><a id="l155"></a><a href="#l155">155</a><td> goog.debug.entryPointRegistry.refList_[i](transformer);<tr><td><a id="l156"></a><a href="#l156">156</a><td> }<tr><td><a id="l157"></a><a href="#l157">157</a><td> monitors.length--;<tr><td><a id="l158"></a><a href="#l158">158</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/debug/error.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>error.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/debug/error.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 Provides a base class for custom Error objects such that the<tr><td><a id="l17"></a><a href="#l17">17</a><td> * stack is correctly maintained.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * You should never need to throw goog.debug.Error(msg) directly, Error(msg) is<tr><td><a id="l20"></a><a href="#l20">20</a><td> * sufficient.<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>goog.provide(&#39;goog.debug.Error&#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> * Base class for custom error objects.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {*=} opt_msg The message associated with the error.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @constructor<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @extends {Error}<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.debug.Error = function(opt_msg) {<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td> // Attempt to ensure there is a stack trace.<tr><td><a id="l37"></a><a href="#l37">37</a><td> if (Error.captureStackTrace) {<tr><td><a id="l38"></a><a href="#l38">38</a><td> Error.captureStackTrace(this, goog.debug.Error);<tr><td><a id="l39"></a><a href="#l39">39</a><td> } else {<tr><td><a id="l40"></a><a href="#l40">40</a><td> var stack = new Error().stack;<tr><td><a id="l41"></a><a href="#l41">41</a><td> if (stack) {<tr><td><a id="l42"></a><a href="#l42">42</a><td> this.stack = stack;<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> if (opt_msg) {<tr><td><a id="l47"></a><a href="#l47">47</a><td> this.message = String(opt_msg);<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> /**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * Whether to report this error to the server. Setting this to false will<tr><td><a id="l52"></a><a href="#l52">52</a><td> * cause the error reporter to not report the error back to the server,<tr><td><a id="l53"></a><a href="#l53">53</a><td> * which can be useful if the client knows that the error has already been<tr><td><a id="l54"></a><a href="#l54">54</a><td> * logged on the server.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @type {boolean}<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td> this.reportErrorToServer = true;<tr><td><a id="l58"></a><a href="#l58">58</a><td>};<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.inherits(goog.debug.Error, Error);<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>/** @override */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.debug.Error.prototype.name = &#39;CustomError&#39;;</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/debug/logbuffer.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>logbuffer.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/debug/logbuffer.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 A buffer for log records. The purpose of this is to improve<tr><td><a id="l17"></a><a href="#l17">17</a><td> * logging performance by re-using old objects when the buffer becomes full and<tr><td><a id="l18"></a><a href="#l18">18</a><td> * to eliminate the need for each app to implement their own log buffer. The<tr><td><a id="l19"></a><a href="#l19">19</a><td> * disadvantage to doing this is that log handlers cannot maintain references to<tr><td><a id="l20"></a><a href="#l20">20</a><td> * log records and expect that they are not overwriten at a later point.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @author agrieve@google.com (Andrew Grieve)<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.debug.LogBuffer&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Creates the log buffer.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @constructor<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @final<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.debug.LogBuffer = function() {<tr><td><a id="l38"></a><a href="#l38">38</a><td> goog.asserts.assert(goog.debug.LogBuffer.isBufferingEnabled(),<tr><td><a id="l39"></a><a href="#l39">39</a><td> &#39;Cannot use goog.debug.LogBuffer without defining &#39; +<tr><td><a id="l40"></a><a href="#l40">40</a><td> &#39;goog.debug.LogBuffer.CAPACITY.&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td> this.clear();<tr><td><a id="l42"></a><a href="#l42">42</a><td>};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * A static method that always returns the same instance of LogBuffer.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {!goog.debug.LogBuffer} The LogBuffer singleton instance.<tr><td><a id="l48"></a><a href="#l48">48</a><td> */<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.debug.LogBuffer.getInstance = function() {<tr><td><a id="l50"></a><a href="#l50">50</a><td> if (!goog.debug.LogBuffer.instance_) {<tr><td><a id="l51"></a><a href="#l51">51</a><td> // This function is written with the return statement after the assignment<tr><td><a id="l52"></a><a href="#l52">52</a><td> // to avoid the jscompiler StripCode bug described in http://b/2608064.<tr><td><a id="l53"></a><a href="#l53">53</a><td> // After that bug is fixed this can be refactored.<tr><td><a id="l54"></a><a href="#l54">54</a><td> goog.debug.LogBuffer.instance_ = new goog.debug.LogBuffer();<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 goog.debug.LogBuffer.instance_;<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td><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> * @define {number} The number of log records to buffer. 0 means disable<tr><td><a id="l62"></a><a href="#l62">62</a><td> * buffering.<tr><td><a id="l63"></a><a href="#l63">63</a><td> */<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.define(&#39;goog.debug.LogBuffer.CAPACITY&#39;, 0);<tr><td><a id="l65"></a><a href="#l65">65</a><td><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> * The array to store the records.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @type {!Array&lt;!goog.debug.LogRecord|undefined&gt;}<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @private<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>goog.debug.LogBuffer.prototype.buffer_;<tr><td><a id="l73"></a><a href="#l73">73</a><td><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> * The index of the most recently added record or -1 if there are no records.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @type {number}<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @private<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>goog.debug.LogBuffer.prototype.curIndex_;<tr><td><a id="l81"></a><a href="#l81">81</a><td><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> * Whether the buffer is at capacity.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @type {boolean}<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @private<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.debug.LogBuffer.prototype.isFull_;<tr><td><a id="l89"></a><a href="#l89">89</a><td><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> * Adds a log record to the buffer, possibly overwriting the oldest record.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {string} msg The string message.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {string} loggerName The name of the source logger.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @return {!goog.debug.LogRecord} The log record.<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.debug.LogBuffer.prototype.addRecord = function(level, msg, loggerName) {<tr><td><a id="l99"></a><a href="#l99">99</a><td> var curIndex = (this.curIndex_ + 1) % goog.debug.LogBuffer.CAPACITY;<tr><td><a id="l100"></a><a href="#l100">100</a><td> this.curIndex_ = curIndex;<tr><td><a id="l101"></a><a href="#l101">101</a><td> if (this.isFull_) {<tr><td><a id="l102"></a><a href="#l102">102</a><td> var ret = this.buffer_[curIndex];<tr><td><a id="l103"></a><a href="#l103">103</a><td> ret.reset(level, msg, loggerName);<tr><td><a id="l104"></a><a href="#l104">104</a><td> return ret;<tr><td><a id="l105"></a><a href="#l105">105</a><td> }<tr><td><a id="l106"></a><a href="#l106">106</a><td> this.isFull_ = curIndex == goog.debug.LogBuffer.CAPACITY - 1;<tr><td><a id="l107"></a><a href="#l107">107</a><td> return this.buffer_[curIndex] =<tr><td><a id="l108"></a><a href="#l108">108</a><td> new goog.debug.LogRecord(level, msg, loggerName);<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<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> * @return {boolean} Whether the log buffer is enabled.<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td>goog.debug.LogBuffer.isBufferingEnabled = function() {<tr><td><a id="l116"></a><a href="#l116">116</a><td> return goog.debug.LogBuffer.CAPACITY &gt; 0;<tr><td><a id="l117"></a><a href="#l117">117</a><td>};<tr><td><a id="l118"></a><a href="#l118">118</a><td><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> * Removes all buffered log records.<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>goog.debug.LogBuffer.prototype.clear = function() {<tr><td><a id="l124"></a><a href="#l124">124</a><td> this.buffer_ = new Array(goog.debug.LogBuffer.CAPACITY);<tr><td><a id="l125"></a><a href="#l125">125</a><td> this.curIndex_ = -1;<tr><td><a id="l126"></a><a href="#l126">126</a><td> this.isFull_ = false;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><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> * Calls the given function for each buffered log record, starting with the<tr><td><a id="l132"></a><a href="#l132">132</a><td> * oldest one.<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @param {function(!goog.debug.LogRecord)} func The function to call.<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.debug.LogBuffer.prototype.forEachRecord = function(func) {<tr><td><a id="l136"></a><a href="#l136">136</a><td> var buffer = this.buffer_;<tr><td><a id="l137"></a><a href="#l137">137</a><td> // Corner case: no records.<tr><td><a id="l138"></a><a href="#l138">138</a><td> if (!buffer[0]) {<tr><td><a id="l139"></a><a href="#l139">139</a><td> return;<tr><td><a id="l140"></a><a href="#l140">140</a><td> }<tr><td><a id="l141"></a><a href="#l141">141</a><td> var curIndex = this.curIndex_;<tr><td><a id="l142"></a><a href="#l142">142</a><td> var i = this.isFull_ ? curIndex : -1;<tr><td><a id="l143"></a><a href="#l143">143</a><td> do {<tr><td><a id="l144"></a><a href="#l144">144</a><td> i = (i + 1) % goog.debug.LogBuffer.CAPACITY;<tr><td><a id="l145"></a><a href="#l145">145</a><td> func(/** @type {!goog.debug.LogRecord} */ (buffer[i]));<tr><td><a id="l146"></a><a href="#l146">146</a><td> } while (i != curIndex);<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</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>