selenium-webdriver 2.48.2 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (524) hide show
  1. package/CHANGES.md +57 -0
  2. package/NOTICE +1 -1
  3. package/README.md +56 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +79 -87
  12. package/firefox/extension.js +10 -18
  13. package/firefox/index.js +173 -173
  14. package/firefox/profile.js +220 -240
  15. package/http/index.js +396 -79
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +88 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +5 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/{webdriver/promise.js → promise.js} +688 -644
  34. package/lib/session.js +79 -0
  35. package/lib/{webdriver/serializable.js → symbols.js} +11 -16
  36. package/lib/test/build.js +4 -4
  37. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  38. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  39. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  40. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  41. package/lib/test/data/readOnlyPage.html +1 -1
  42. package/lib/test/data/selectPage.html +18 -2
  43. package/lib/test/fileserver.js +3 -4
  44. package/lib/test/index.js +7 -3
  45. package/lib/test/resources.js +1 -1
  46. package/lib/until.js +428 -0
  47. package/lib/webdriver.js +2351 -0
  48. package/net/portprober.js +15 -11
  49. package/opera.js +295 -314
  50. package/package.json +6 -5
  51. package/phantomjs.js +135 -140
  52. package/proxy.js +6 -4
  53. package/remote/index.js +229 -221
  54. package/safari.js +319 -310
  55. package/test/chrome/options_test.js +11 -9
  56. package/test/element_finding_test.js +51 -13
  57. package/test/error_test.js +163 -0
  58. package/test/execute_script_test.js +1 -1
  59. package/test/http/http_test.js +317 -55
  60. package/test/http/util_test.js +25 -23
  61. package/test/io_test.js +6 -1
  62. package/test/lib/by_test.js +127 -0
  63. package/test/lib/capabilities_test.js +84 -0
  64. package/test/lib/events_test.js +177 -0
  65. package/test/lib/logging_test.js +272 -0
  66. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  67. package/test/lib/promise_error_test.js +808 -0
  68. package/test/lib/promise_flow_test.js +2282 -0
  69. package/test/lib/promise_generator_test.js +308 -0
  70. package/test/lib/promise_test.js +996 -0
  71. package/test/lib/testutil.js +90 -0
  72. package/test/lib/until_test.js +436 -0
  73. package/test/lib/webdriver_test.js +2207 -0
  74. package/test/page_loading_test.js +7 -9
  75. package/test/stale_element_test.js +2 -2
  76. package/test/testing/assert_test.js +374 -0
  77. package/test/testing/index_test.js +9 -11
  78. package/testing/assert.js +334 -17
  79. package/testing/index.js +10 -0
  80. package/_base.js +0 -200
  81. package/docs/Changes.html +0 -356
  82. package/docs/class_bot_Error.html +0 -15
  83. package/docs/class_webdriver_ActionSequence.html +0 -115
  84. package/docs/class_webdriver_Alert.html +0 -24
  85. package/docs/class_webdriver_AlertPromise.html +0 -92
  86. package/docs/class_webdriver_Capabilities.html +0 -60
  87. package/docs/class_webdriver_Command.html +0 -15
  88. package/docs/class_webdriver_EventEmitter.html +0 -35
  89. package/docs/class_webdriver_FileDetector.html +0 -21
  90. package/docs/class_webdriver_Locator.html +0 -12
  91. package/docs/class_webdriver_Serializable.html +0 -9
  92. package/docs/class_webdriver_Session.html +0 -13
  93. package/docs/class_webdriver_TouchSequence.html +0 -49
  94. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  95. package/docs/class_webdriver_WebDriver.html +0 -313
  96. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  97. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  98. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  99. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  100. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  101. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  102. package/docs/class_webdriver_WebElement.html +0 -223
  103. package/docs/class_webdriver_WebElementPromise.html +0 -274
  104. package/docs/class_webdriver_http_Executor.html +0 -22
  105. package/docs/class_webdriver_http_Request.html +0 -12
  106. package/docs/class_webdriver_http_Response.html +0 -13
  107. package/docs/class_webdriver_logging_Entry.html +0 -15
  108. package/docs/class_webdriver_logging_Level.html +0 -55
  109. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  110. package/docs/class_webdriver_logging_Logger.html +0 -119
  111. package/docs/class_webdriver_logging_Preferences.html +0 -8
  112. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  113. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  114. package/docs/class_webdriver_promise_Deferred.html +0 -84
  115. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  116. package/docs/class_webdriver_promise_Promise.html +0 -75
  117. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  118. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  119. package/docs/class_webdriver_testing_Assertion.html +0 -99
  120. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  121. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  122. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  123. package/docs/class_webdriver_until_Condition.html +0 -7
  124. package/docs/dossier.css +0 -1
  125. package/docs/dossier.js +0 -86
  126. package/docs/enum_bot_ErrorCode.html +0 -3
  127. package/docs/enum_bot_Error_State.html +0 -2
  128. package/docs/enum_webdriver_Browser.html +0 -2
  129. package/docs/enum_webdriver_Button.html +0 -2
  130. package/docs/enum_webdriver_Capability.html +0 -33
  131. package/docs/enum_webdriver_CommandName.html +0 -3
  132. package/docs/enum_webdriver_Key.html +0 -12
  133. package/docs/enum_webdriver_logging_Type.html +0 -6
  134. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  135. package/docs/index.html +0 -125
  136. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  137. package/docs/interface_webdriver_http_Client.html +0 -10
  138. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  139. package/docs/module_selenium-webdriver.html +0 -23
  140. package/docs/module_selenium-webdriver__base.html +0 -23
  141. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  142. package/docs/module_selenium-webdriver_builder.html +0 -2
  143. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  144. package/docs/module_selenium-webdriver_chrome.html +0 -90
  145. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  146. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  147. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  148. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  149. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  150. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  151. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  152. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  153. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  154. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  155. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  156. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  157. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  158. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  159. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  160. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  161. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  162. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  163. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  164. package/docs/module_selenium-webdriver_error.html +0 -4
  165. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  166. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  167. package/docs/module_selenium-webdriver_executors.html +0 -10
  168. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  169. package/docs/module_selenium-webdriver_firefox.html +0 -68
  170. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  171. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  172. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  173. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  174. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  175. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  176. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  177. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  178. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_http.html +0 -9
  180. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  181. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  182. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  183. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  184. package/docs/module_selenium-webdriver_http_util.html +0 -17
  185. package/docs/module_selenium-webdriver_ie.html +0 -11
  186. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  187. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  188. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  189. package/docs/module_selenium-webdriver_io.html +0 -37
  190. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  191. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  192. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  193. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  194. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  195. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  196. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  197. package/docs/module_selenium-webdriver_net.html +0 -7
  198. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  199. package/docs/module_selenium-webdriver_opera.html +0 -62
  200. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  201. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  202. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  203. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  204. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  205. package/docs/module_selenium-webdriver_proxy.html +0 -28
  206. package/docs/module_selenium-webdriver_remote.html +0 -8
  207. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  208. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  209. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  210. package/docs/module_selenium-webdriver_safari.html +0 -9
  211. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  212. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  213. package/docs/module_selenium-webdriver_testing.html +0 -74
  214. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  215. package/docs/namespace_bot.html +0 -4
  216. package/docs/namespace_bot_json.html +0 -20
  217. package/docs/namespace_bot_response.html +0 -18
  218. package/docs/namespace_bot_userAgent.html +0 -33
  219. package/docs/namespace_webdriver.html +0 -30
  220. package/docs/namespace_webdriver_By.html +0 -56
  221. package/docs/namespace_webdriver_http.html +0 -6
  222. package/docs/namespace_webdriver_logging.html +0 -70
  223. package/docs/namespace_webdriver_promise.html +0 -688
  224. package/docs/namespace_webdriver_stacktrace.html +0 -17
  225. package/docs/namespace_webdriver_testing.html +0 -7
  226. package/docs/namespace_webdriver_testing_assert.html +0 -9
  227. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  228. package/docs/namespace_webdriver_until.html +0 -82
  229. package/docs/source/_base.js.src.html +0 -1
  230. package/docs/source/builder.js.src.html +0 -1
  231. package/docs/source/chrome.js.src.html +0 -1
  232. package/docs/source/error.js.src.html +0 -1
  233. package/docs/source/executors.js.src.html +0 -1
  234. package/docs/source/firefox/binary.js.src.html +0 -1
  235. package/docs/source/firefox/extension.js.src.html +0 -1
  236. package/docs/source/firefox/index.js.src.html +0 -1
  237. package/docs/source/firefox/profile.js.src.html +0 -1
  238. package/docs/source/http/index.js.src.html +0 -1
  239. package/docs/source/http/util.js.src.html +0 -1
  240. package/docs/source/ie.js.src.html +0 -1
  241. package/docs/source/index.js.src.html +0 -1
  242. package/docs/source/io/exec.js.src.html +0 -1
  243. package/docs/source/io/index.js.src.html +0 -1
  244. package/docs/source/lib/atoms/error.js.src.html +0 -1
  245. package/docs/source/lib/atoms/json.js.src.html +0 -1
  246. package/docs/source/lib/atoms/response.js.src.html +0 -1
  247. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  248. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  249. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  250. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  251. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  252. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  254. package/docs/source/lib/goog/base.js.src.html +0 -1
  255. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  256. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  257. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  261. package/docs/source/lib/goog/deps.js.src.html +0 -1
  262. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  263. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  264. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  265. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  266. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  271. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  272. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  273. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  282. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  283. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  284. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  285. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  286. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  291. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  292. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  293. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  294. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  295. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  296. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  304. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  305. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  306. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  310. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  311. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  314. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  315. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  316. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  318. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  319. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  320. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  322. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  323. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  326. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  327. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  328. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  344. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  345. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  346. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  347. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  348. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  349. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  350. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  351. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  366. package/docs/source/net/index.js.src.html +0 -1
  367. package/docs/source/net/portprober.js.src.html +0 -1
  368. package/docs/source/opera.js.src.html +0 -1
  369. package/docs/source/phantomjs.js.src.html +0 -1
  370. package/docs/source/proxy.js.src.html +0 -1
  371. package/docs/source/remote/index.js.src.html +0 -1
  372. package/docs/source/safari.js.src.html +0 -1
  373. package/docs/source/testing/assert.js.src.html +0 -1
  374. package/docs/source/testing/index.js.src.html +0 -1
  375. package/docs/types.js +0 -1
  376. package/lib/atoms/error.js +0 -202
  377. package/lib/atoms/json.js +0 -80
  378. package/lib/atoms/response.js +0 -110
  379. package/lib/atoms/userAgent.js +0 -257
  380. package/lib/goog/LICENSE +0 -176
  381. package/lib/goog/array/array.js +0 -1654
  382. package/lib/goog/asserts/asserts.js +0 -365
  383. package/lib/goog/async/freelist.js +0 -88
  384. package/lib/goog/async/nexttick.js +0 -241
  385. package/lib/goog/async/run.js +0 -133
  386. package/lib/goog/async/workqueue.js +0 -139
  387. package/lib/goog/base.js +0 -2548
  388. package/lib/goog/debug/debug.js +0 -653
  389. package/lib/goog/debug/entrypointregistry.js +0 -158
  390. package/lib/goog/debug/error.js +0 -63
  391. package/lib/goog/debug/logbuffer.js +0 -148
  392. package/lib/goog/debug/logger.js +0 -873
  393. package/lib/goog/debug/logrecord.js +0 -242
  394. package/lib/goog/deps.js +0 -151
  395. package/lib/goog/disposable/disposable.js +0 -307
  396. package/lib/goog/disposable/idisposable.js +0 -45
  397. package/lib/goog/dom/browserfeature.js +0 -72
  398. package/lib/goog/dom/dom.js +0 -2991
  399. package/lib/goog/dom/nodetype.js +0 -48
  400. package/lib/goog/dom/safe.js +0 -347
  401. package/lib/goog/dom/tagname.js +0 -160
  402. package/lib/goog/dom/tags.js +0 -41
  403. package/lib/goog/dom/vendor.js +0 -96
  404. package/lib/goog/events/browserevent.js +0 -400
  405. package/lib/goog/events/browserfeature.js +0 -85
  406. package/lib/goog/events/event.js +0 -143
  407. package/lib/goog/events/eventid.js +0 -47
  408. package/lib/goog/events/events.js +0 -984
  409. package/lib/goog/events/eventtarget.js +0 -394
  410. package/lib/goog/events/eventtype.js +0 -237
  411. package/lib/goog/events/keycodes.js +0 -427
  412. package/lib/goog/events/listenable.js +0 -335
  413. package/lib/goog/events/listener.js +0 -131
  414. package/lib/goog/events/listenermap.js +0 -308
  415. package/lib/goog/fs/url.js +0 -109
  416. package/lib/goog/functions/functions.js +0 -442
  417. package/lib/goog/html/safehtml.js +0 -757
  418. package/lib/goog/html/safescript.js +0 -234
  419. package/lib/goog/html/safestyle.js +0 -442
  420. package/lib/goog/html/safestylesheet.js +0 -276
  421. package/lib/goog/html/safeurl.js +0 -398
  422. package/lib/goog/html/trustedresourceurl.js +0 -224
  423. package/lib/goog/html/uncheckedconversions.js +0 -232
  424. package/lib/goog/i18n/bidi.js +0 -908
  425. package/lib/goog/iter/iter.js +0 -1302
  426. package/lib/goog/json/json.js +0 -363
  427. package/lib/goog/labs/testing/assertthat.js +0 -58
  428. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  429. package/lib/goog/labs/testing/matcher.js +0 -80
  430. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  431. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  432. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  433. package/lib/goog/labs/useragent/browser.js +0 -341
  434. package/lib/goog/labs/useragent/engine.js +0 -160
  435. package/lib/goog/labs/useragent/platform.js +0 -160
  436. package/lib/goog/labs/useragent/util.js +0 -148
  437. package/lib/goog/log/log.js +0 -197
  438. package/lib/goog/math/box.js +0 -398
  439. package/lib/goog/math/coordinate.js +0 -268
  440. package/lib/goog/math/math.js +0 -451
  441. package/lib/goog/math/rect.js +0 -476
  442. package/lib/goog/math/size.js +0 -227
  443. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  444. package/lib/goog/net/xhrlike.js +0 -124
  445. package/lib/goog/net/xmlhttp.js +0 -246
  446. package/lib/goog/net/xmlhttpfactory.js +0 -67
  447. package/lib/goog/object/object.js +0 -686
  448. package/lib/goog/promise/promise.js +0 -1350
  449. package/lib/goog/promise/resolver.js +0 -48
  450. package/lib/goog/promise/thenable.js +0 -126
  451. package/lib/goog/reflect/reflect.js +0 -77
  452. package/lib/goog/string/const.js +0 -182
  453. package/lib/goog/string/string.js +0 -1599
  454. package/lib/goog/string/typedstring.js +0 -48
  455. package/lib/goog/structs/collection.js +0 -56
  456. package/lib/goog/structs/map.js +0 -457
  457. package/lib/goog/structs/set.js +0 -279
  458. package/lib/goog/structs/structs.js +0 -354
  459. package/lib/goog/style/style.js +0 -2037
  460. package/lib/goog/testing/asserts.js +0 -1278
  461. package/lib/goog/testing/events/events.js +0 -767
  462. package/lib/goog/testing/functionmock.js +0 -175
  463. package/lib/goog/testing/jsunit.js +0 -162
  464. package/lib/goog/testing/loosemock.js +0 -242
  465. package/lib/goog/testing/mock.js +0 -645
  466. package/lib/goog/testing/mockclock.js +0 -606
  467. package/lib/goog/testing/mockcontrol.js +0 -220
  468. package/lib/goog/testing/mockinterface.js +0 -45
  469. package/lib/goog/testing/mockmatchers.js +0 -400
  470. package/lib/goog/testing/objectpropertystring.js +0 -68
  471. package/lib/goog/testing/propertyreplacer.js +0 -262
  472. package/lib/goog/testing/recordfunction.js +0 -215
  473. package/lib/goog/testing/stacktrace.js +0 -594
  474. package/lib/goog/testing/strictmock.js +0 -130
  475. package/lib/goog/testing/testcase.js +0 -1629
  476. package/lib/goog/testing/testrunner.js +0 -440
  477. package/lib/goog/uri/uri.js +0 -1524
  478. package/lib/goog/uri/utils.js +0 -1064
  479. package/lib/goog/useragent/product.js +0 -183
  480. package/lib/goog/useragent/product_isversion.js +0 -144
  481. package/lib/goog/useragent/useragent.js +0 -572
  482. package/lib/webdriver/actionsequence.js +0 -356
  483. package/lib/webdriver/builder.js +0 -207
  484. package/lib/webdriver/capabilities.js +0 -412
  485. package/lib/webdriver/events.js +0 -179
  486. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  487. package/lib/webdriver/http/corsclient.js +0 -133
  488. package/lib/webdriver/http/http.js +0 -525
  489. package/lib/webdriver/http/xhrclient.js +0 -67
  490. package/lib/webdriver/locators.js +0 -257
  491. package/lib/webdriver/logging.js +0 -347
  492. package/lib/webdriver/session.js +0 -74
  493. package/lib/webdriver/stacktrace.js +0 -619
  494. package/lib/webdriver/test/builder_test.js +0 -53
  495. package/lib/webdriver/test/capabilities_test.js +0 -72
  496. package/lib/webdriver/test/events_test.js +0 -203
  497. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  498. package/lib/webdriver/test/http/http_test.js +0 -428
  499. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  500. package/lib/webdriver/test/locators_test.js +0 -59
  501. package/lib/webdriver/test/logging_test.js +0 -85
  502. package/lib/webdriver/test/promise_error_test.js +0 -892
  503. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  504. package/lib/webdriver/test/promise_generator_test.js +0 -323
  505. package/lib/webdriver/test/promise_test.js +0 -2012
  506. package/lib/webdriver/test/stacktrace_test.js +0 -480
  507. package/lib/webdriver/test/test_bootstrap.js +0 -67
  508. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  509. package/lib/webdriver/test/testing/client_test.js +0 -88
  510. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  511. package/lib/webdriver/test/testutil.js +0 -209
  512. package/lib/webdriver/test/testutil_test.js +0 -104
  513. package/lib/webdriver/test/until_test.js +0 -411
  514. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  515. package/lib/webdriver/test/webdriver_test.js +0 -2369
  516. package/lib/webdriver/testing/asserts.js +0 -487
  517. package/lib/webdriver/testing/client.js +0 -179
  518. package/lib/webdriver/testing/jsunit.js +0 -363
  519. package/lib/webdriver/testing/testcase.js +0 -168
  520. package/lib/webdriver/testing/window.js +0 -244
  521. package/lib/webdriver/touchsequence.js +0 -248
  522. package/lib/webdriver/until.js +0 -412
  523. package/lib/webdriver/webdriver.js +0 -2511
  524. package/test/_base_test.js +0 -129
@@ -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>size.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/math/size.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 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 utility class for representing two-dimensional sizes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author brenneman@google.com (Shawn Brenneman)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.math.Size&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Class for representing sizes consisting of a width and height. Undefined<tr><td><a id="l27"></a><a href="#l27">27</a><td> * width and height support is deprecated and results in compiler warning.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {number} width Width.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {number} height Height.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @struct<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> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.math.Size = function(width, height) {<tr><td><a id="l34"></a><a href="#l34">34</a><td> /**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Width<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @type {number}<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td> this.width = width;<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> * Height<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {number}<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td> this.height = height;<tr><td><a id="l45"></a><a href="#l45">45</a><td>};<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>/**<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Compares sizes for equality.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {goog.math.Size} a A Size.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {goog.math.Size} b A Size.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {boolean} True iff the sizes have equal widths and equal<tr><td><a id="l53"></a><a href="#l53">53</a><td> * heights, or if both are null.<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.math.Size.equals = function(a, b) {<tr><td><a id="l56"></a><a href="#l56">56</a><td> if (a == b) {<tr><td><a id="l57"></a><a href="#l57">57</a><td> return 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> if (!a || !b) {<tr><td><a id="l60"></a><a href="#l60">60</a><td> return false;<tr><td><a id="l61"></a><a href="#l61">61</a><td> }<tr><td><a id="l62"></a><a href="#l62">62</a><td> return a.width == b.width &amp;&amp; a.height == b.height;<tr><td><a id="l63"></a><a href="#l63">63</a><td>};<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>/**<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {!goog.math.Size} A new copy of the Size.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.math.Size.prototype.clone = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td> return new goog.math.Size(this.width, this.height);<tr><td><a id="l71"></a><a href="#l71">71</a><td>};<tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td>if (goog.DEBUG) {<tr><td><a id="l75"></a><a href="#l75">75</a><td> /**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * Returns a nice string representing size.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @return {string} In the form (50 x 73).<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @override<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.math.Size.prototype.toString = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td> return &#39;(&#39; + this.width + &#39; x &#39; + this.height + &#39;)&#39;;<tr><td><a id="l82"></a><a href="#l82">82</a><td> };<tr><td><a id="l83"></a><a href="#l83">83</a><td>}<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>/**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @return {number} The longer of the two dimensions in the size.<tr><td><a id="l88"></a><a href="#l88">88</a><td> */<tr><td><a id="l89"></a><a href="#l89">89</a><td>goog.math.Size.prototype.getLongest = function() {<tr><td><a id="l90"></a><a href="#l90">90</a><td> return Math.max(this.width, this.height);<tr><td><a id="l91"></a><a href="#l91">91</a><td>};<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> * @return {number} The shorter of the two dimensions in the size.<tr><td><a id="l96"></a><a href="#l96">96</a><td> */<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.math.Size.prototype.getShortest = function() {<tr><td><a id="l98"></a><a href="#l98">98</a><td> return Math.min(this.width, this.height);<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> * @return {number} The area of the size (width * height).<tr><td><a id="l104"></a><a href="#l104">104</a><td> */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.math.Size.prototype.area = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td> return this.width * this.height;<tr><td><a id="l107"></a><a href="#l107">107</a><td>};<tr><td><a id="l108"></a><a href="#l108">108</a><td><tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>/**<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @return {number} The perimeter of the size (width + height) * 2.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>goog.math.Size.prototype.perimeter = function() {<tr><td><a id="l114"></a><a href="#l114">114</a><td> return (this.width + this.height) * 2;<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> * @return {number} The ratio of the size&#39;s width to its height.<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td>goog.math.Size.prototype.aspectRatio = function() {<tr><td><a id="l122"></a><a href="#l122">122</a><td> return this.width / this.height;<tr><td><a id="l123"></a><a href="#l123">123</a><td>};<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>/**<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {boolean} True if the size has zero area, false if both dimensions<tr><td><a id="l128"></a><a href="#l128">128</a><td> * are non-zero numbers.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>goog.math.Size.prototype.isEmpty = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td> return !this.area();<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> * Clamps the width and height parameters upward to integer values.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!goog.math.Size} This size with ceil&#39;d components.<tr><td><a id="l138"></a><a href="#l138">138</a><td> */<tr><td><a id="l139"></a><a href="#l139">139</a><td>goog.math.Size.prototype.ceil = function() {<tr><td><a id="l140"></a><a href="#l140">140</a><td> this.width = Math.ceil(this.width);<tr><td><a id="l141"></a><a href="#l141">141</a><td> this.height = Math.ceil(this.height);<tr><td><a id="l142"></a><a href="#l142">142</a><td> return this;<tr><td><a id="l143"></a><a href="#l143">143</a><td>};<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>/**<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @return {boolean} True if this Size is the same size or smaller than the<tr><td><a id="l149"></a><a href="#l149">149</a><td> * target size in both dimensions.<tr><td><a id="l150"></a><a href="#l150">150</a><td> */<tr><td><a id="l151"></a><a href="#l151">151</a><td>goog.math.Size.prototype.fitsInside = function(target) {<tr><td><a id="l152"></a><a href="#l152">152</a><td> return this.width &lt;= target.width &amp;&amp; this.height &lt;= target.height;<tr><td><a id="l153"></a><a href="#l153">153</a><td>};<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td>/**<tr><td><a id="l157"></a><a href="#l157">157</a><td> * Clamps the width and height parameters downward to integer values.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @return {!goog.math.Size} This size with floored components.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>goog.math.Size.prototype.floor = function() {<tr><td><a id="l161"></a><a href="#l161">161</a><td> this.width = Math.floor(this.width);<tr><td><a id="l162"></a><a href="#l162">162</a><td> this.height = Math.floor(this.height);<tr><td><a id="l163"></a><a href="#l163">163</a><td> return this;<tr><td><a id="l164"></a><a href="#l164">164</a><td>};<tr><td><a id="l165"></a><a href="#l165">165</a><td><tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td>/**<tr><td><a id="l168"></a><a href="#l168">168</a><td> * Rounds the width and height parameters to integer values.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {!goog.math.Size} This size with rounded components.<tr><td><a id="l170"></a><a href="#l170">170</a><td> */<tr><td><a id="l171"></a><a href="#l171">171</a><td>goog.math.Size.prototype.round = function() {<tr><td><a id="l172"></a><a href="#l172">172</a><td> this.width = Math.round(this.width);<tr><td><a id="l173"></a><a href="#l173">173</a><td> this.height = Math.round(this.height);<tr><td><a id="l174"></a><a href="#l174">174</a><td> return this;<tr><td><a id="l175"></a><a href="#l175">175</a><td>};<tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td><tr><td><a id="l178"></a><a href="#l178">178</a><td>/**<tr><td><a id="l179"></a><a href="#l179">179</a><td> * Scales this size by the given scale factors. The width and height are scaled<tr><td><a id="l180"></a><a href="#l180">180</a><td> * by {@code sx} and {@code opt_sy} respectively. If {@code opt_sy} is not<tr><td><a id="l181"></a><a href="#l181">181</a><td> * given, then {@code sx} is used for both the width and height.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @param {number} sx The scale factor to use for the width.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @param {number=} opt_sy The scale factor to use for the height.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @return {!goog.math.Size} This Size object after scaling.<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td>goog.math.Size.prototype.scale = function(sx, opt_sy) {<tr><td><a id="l187"></a><a href="#l187">187</a><td> var sy = goog.isNumber(opt_sy) ? opt_sy : sx;<tr><td><a id="l188"></a><a href="#l188">188</a><td> this.width *= sx;<tr><td><a id="l189"></a><a href="#l189">189</a><td> this.height *= sy;<tr><td><a id="l190"></a><a href="#l190">190</a><td> return this;<tr><td><a id="l191"></a><a href="#l191">191</a><td>};<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * Uniformly scales the size to perfectly cover the dimensions of a given size.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * If the size is already larger than the target, it will be scaled down to the<tr><td><a id="l197"></a><a href="#l197">197</a><td> * minimum size at which it still covers the entire target. The original aspect<tr><td><a id="l198"></a><a href="#l198">198</a><td> * ratio will be preserved.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * This function assumes that both Sizes contain strictly positive dimensions.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @return {!goog.math.Size} This Size object, after optional scaling.<tr><td><a id="l203"></a><a href="#l203">203</a><td> */<tr><td><a id="l204"></a><a href="#l204">204</a><td>goog.math.Size.prototype.scaleToCover = function(target) {<tr><td><a id="l205"></a><a href="#l205">205</a><td> var s = this.aspectRatio() &lt;= target.aspectRatio() ?<tr><td><a id="l206"></a><a href="#l206">206</a><td> target.width / this.width :<tr><td><a id="l207"></a><a href="#l207">207</a><td> target.height / this.height;<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td> return this.scale(s);<tr><td><a id="l210"></a><a href="#l210">210</a><td>};<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td>/**<tr><td><a id="l214"></a><a href="#l214">214</a><td> * Uniformly scales the size to fit inside the dimensions of a given size. The<tr><td><a id="l215"></a><a href="#l215">215</a><td> * original aspect ratio will be preserved.<tr><td><a id="l216"></a><a href="#l216">216</a><td> *<tr><td><a id="l217"></a><a href="#l217">217</a><td> * This function assumes that both Sizes contain strictly positive dimensions.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @return {!goog.math.Size} This Size object, after optional scaling.<tr><td><a id="l220"></a><a href="#l220">220</a><td> */<tr><td><a id="l221"></a><a href="#l221">221</a><td>goog.math.Size.prototype.scaleToFit = function(target) {<tr><td><a id="l222"></a><a href="#l222">222</a><td> var s = this.aspectRatio() &gt; target.aspectRatio() ?<tr><td><a id="l223"></a><a href="#l223">223</a><td> target.width / this.width :<tr><td><a id="l224"></a><a href="#l224">224</a><td> target.height / this.height;<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td> return this.scale(s);<tr><td><a id="l227"></a><a href="#l227">227</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>
@@ -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>wrapperxmlhttpfactory.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/net/wrapperxmlhttpfactory.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 Implementation of XmlHttpFactory which allows construction from<tr><td><a id="l17"></a><a href="#l17">17</a><td> * simple factory methods.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<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.net.WrapperXmlHttpFactory&#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>/** @suppress {extraRequire} Typedef. */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.net.XhrLike&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#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><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * An xhr factory subclass which can be constructed using two factory methods.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * This exists partly to allow the preservation of goog.net.XmlHttp.setFactory()<tr><td><a id="l32"></a><a href="#l32">32</a><td> * with an unchanged signature.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {function():!goog.net.XhrLike.OrNative} xhrFactory<tr><td><a id="l34"></a><a href="#l34">34</a><td> * A function which returns a new XHR object.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {function():!Object} optionsFactory A function which returns the<tr><td><a id="l36"></a><a href="#l36">36</a><td> * options associated with xhr objects from this factory.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @constructor<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @final<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.WrapperXmlHttpFactory = function(xhrFactory, optionsFactory) {<tr><td><a id="l42"></a><a href="#l42">42</a><td> goog.net.XmlHttpFactory.call(this);<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> * XHR factory method.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @type {function() : !goog.net.XhrLike.OrNative}<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @private<tr><td><a id="l48"></a><a href="#l48">48</a><td> */<tr><td><a id="l49"></a><a href="#l49">49</a><td> this.xhrFactory_ = xhrFactory;<tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td> /**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Options factory method.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @type {function() : !Object}<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @private<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td> this.optionsFactory_ = optionsFactory;<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.inherits(goog.net.WrapperXmlHttpFactory, goog.net.XmlHttpFactory);<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>/** @override */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.net.WrapperXmlHttpFactory.prototype.createInstance = function() {<tr><td><a id="l63"></a><a href="#l63">63</a><td> return this.xhrFactory_();<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/** @override */<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.net.WrapperXmlHttpFactory.prototype.getOptions = function() {<tr><td><a id="l69"></a><a href="#l69">69</a><td> return this.optionsFactory_();<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<tr><td><a id="l71"></a><a href="#l71">71</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>
@@ -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>xhrlike.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/net/xhrlike.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 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>goog.provide(&#39;goog.net.XhrLike&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Interface for the common parts of XMLHttpRequest.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Mostly copied from externs/w3c_xml.js.<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @interface<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/<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.net.XhrLike = function() {};<tr><td><a id="l28"></a><a href="#l28">28</a><td><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> * Typedef that refers to either native or custom-implemented XHR objects.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @typedef {!goog.net.XhrLike|!XMLHttpRequest}<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.net.XhrLike.OrNative;<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>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @type {function()|null|undefined}<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#handler-xhr-onreadystatechange<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.XhrLike.prototype.onreadystatechange;<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> * @type {string}<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsetext-attribute<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.net.XhrLike.prototype.responseText;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @type {Document}<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsexml-attribute<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.net.XhrLike.prototype.responseXML;<tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td><tr><td><a id="l58"></a><a href="#l58">58</a><td>/**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @type {number}<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#readystate<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.net.XhrLike.prototype.readyState;<tr><td><a id="l63"></a><a href="#l63">63</a><td><tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @type {number}<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#status<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.net.XhrLike.prototype.status;<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td>/**<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @type {string}<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#statustext<tr><td><a id="l75"></a><a href="#l75">75</a><td> */<tr><td><a id="l76"></a><a href="#l76">76</a><td>goog.net.XhrLike.prototype.statusText;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @param {string} method<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {string} url<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @param {?boolean=} opt_async<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @param {?string=} opt_user<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {?string=} opt_password<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-open()-method<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>goog.net.XhrLike.prototype.open = function(method, url, opt_async, opt_user,<tr><td><a id="l88"></a><a href="#l88">88</a><td> opt_password) {};<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> * @param {ArrayBuffer|ArrayBufferView|Blob|Document|FormData|string=} opt_data<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-send()-method<tr><td><a id="l94"></a><a href="#l94">94</a><td> */<tr><td><a id="l95"></a><a href="#l95">95</a><td>goog.net.XhrLike.prototype.send = function(opt_data) {};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-abort()-method<tr><td><a id="l100"></a><a href="#l100">100</a><td> */<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.net.XhrLike.prototype.abort = function() {};<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>/**<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string} header<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @param {string} value<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-setrequestheader()-method<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.net.XhrLike.prototype.setRequestHeader = function(header, value) {};<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> * @param {string} header<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {string}<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-getresponseheader()-method<tr><td><a id="l116"></a><a href="#l116">116</a><td> */<tr><td><a id="l117"></a><a href="#l117">117</a><td>goog.net.XhrLike.prototype.getResponseHeader = function(header) {};<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> * @return {string}<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders()-method<tr><td><a id="l123"></a><a href="#l123">123</a><td> */<tr><td><a id="l124"></a><a href="#l124">124</a><td>goog.net.XhrLike.prototype.getAllResponseHeaders = function() {};</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>
@@ -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>xmlhttp.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/net/xmlhttp.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 Low level handling of XMLHttpRequest.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<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.net.DefaultXmlHttpFactory&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.net.XmlHttp&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.net.XmlHttp.OptionType&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.net.XmlHttp.ReadyState&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.net.XmlHttpDefines&#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.net.WrapperXmlHttpFactory&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#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>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Static class for creating XMLHttpRequest objects.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @return {!goog.net.XhrLike.OrNative} A new XMLHttpRequest object.<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.net.XmlHttp = function() {<tr><td><a id="l37"></a><a href="#l37">37</a><td> return goog.net.XmlHttp.factory_.createInstance();<tr><td><a id="l38"></a><a href="#l38">38</a><td>};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to<tr><td><a id="l43"></a><a href="#l43">43</a><td> * true bypasses the ActiveX probing code.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * NOTE(ruilopes): Due to the way JSCompiler works, this define *will not* strip<tr><td><a id="l45"></a><a href="#l45">45</a><td> * out the ActiveX probing code from binaries. To achieve this, use<tr><td><a id="l46"></a><a href="#l46">46</a><td> * {@code goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR} instead.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * TODO(ruilopes): Collapse both defines.<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.define(&#39;goog.net.XmlHttp.ASSUME_NATIVE_XHR&#39;, false);<tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td>/** @const */<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.net.XmlHttpDefines = {};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to<tr><td><a id="l58"></a><a href="#l58">58</a><td> * true eliminates the ActiveX probing code.<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.define(&#39;goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR&#39;, false);<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>/**<tr><td><a id="l64"></a><a href="#l64">64</a><td> * Gets the options to use with the XMLHttpRequest objects obtained using<tr><td><a id="l65"></a><a href="#l65">65</a><td> * the static methods.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @return {Object} The options.<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.net.XmlHttp.getOptions = function() {<tr><td><a id="l69"></a><a href="#l69">69</a><td> return goog.net.XmlHttp.factory_.getOptions();<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td>/**<tr><td><a id="l74"></a><a href="#l74">74</a><td> * Type of options that an XmlHttp object can have.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @enum {number}<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td>goog.net.XmlHttp.OptionType = {<tr><td><a id="l78"></a><a href="#l78">78</a><td> /**<tr><td><a id="l79"></a><a href="#l79">79</a><td> * Whether a goog.nullFunction should be used to clear the onreadystatechange<tr><td><a id="l80"></a><a href="#l80">80</a><td> * handler instead of null.<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td> USE_NULL_FUNCTION: 0,<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> * NOTE(user): In IE if send() errors on a *local* request the readystate<tr><td><a id="l86"></a><a href="#l86">86</a><td> * is still changed to COMPLETE. We need to ignore it and allow the<tr><td><a id="l87"></a><a href="#l87">87</a><td> * try/catch around send() to pick up the error.<tr><td><a id="l88"></a><a href="#l88">88</a><td> */<tr><td><a id="l89"></a><a href="#l89">89</a><td> LOCAL_REQUEST_ERROR: 1<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><tr><td><a id="l93"></a><a href="#l93">93</a><td>/**<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Status constants for XMLHTTP, matches:<tr><td><a id="l95"></a><a href="#l95">95</a><td> * http://msdn.microsoft.com/library/default.asp?url=/library/<tr><td><a id="l96"></a><a href="#l96">96</a><td> * en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @enum {number}<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td>goog.net.XmlHttp.ReadyState = {<tr><td><a id="l100"></a><a href="#l100">100</a><td> /**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Constant for when xmlhttprequest.readyState is uninitialized<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td> UNINITIALIZED: 0,<tr><td><a id="l104"></a><a href="#l104">104</a><td><tr><td><a id="l105"></a><a href="#l105">105</a><td> /**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Constant for when xmlhttprequest.readyState is loading.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td> LOADING: 1,<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> * Constant for when xmlhttprequest.readyState is loaded.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td> LOADED: 2,<tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td> /**<tr><td><a id="l116"></a><a href="#l116">116</a><td> * Constant for when xmlhttprequest.readyState is in an interactive state.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td> INTERACTIVE: 3,<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> * Constant for when xmlhttprequest.readyState is completed<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td> COMPLETE: 4<tr><td><a id="l124"></a><a href="#l124">124</a><td>};<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>/**<tr><td><a id="l128"></a><a href="#l128">128</a><td> * The global factory instance for creating XMLHttpRequest objects.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @type {goog.net.XmlHttpFactory}<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @private<tr><td><a id="l131"></a><a href="#l131">131</a><td> */<tr><td><a id="l132"></a><a href="#l132">132</a><td>goog.net.XmlHttp.factory_;<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> * Sets the factories for creating XMLHttpRequest objects and their options.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {Function} factory The factory for XMLHttpRequest objects.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {Function} optionsFactory The factory for options.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @deprecated Use setGlobalFactory instead.<tr><td><a id="l140"></a><a href="#l140">140</a><td> */<tr><td><a id="l141"></a><a href="#l141">141</a><td>goog.net.XmlHttp.setFactory = function(factory, optionsFactory) {<tr><td><a id="l142"></a><a href="#l142">142</a><td> goog.net.XmlHttp.setGlobalFactory(new goog.net.WrapperXmlHttpFactory(<tr><td><a id="l143"></a><a href="#l143">143</a><td> goog.asserts.assert(factory),<tr><td><a id="l144"></a><a href="#l144">144</a><td> goog.asserts.assert(optionsFactory)));<tr><td><a id="l145"></a><a href="#l145">145</a><td>};<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td>/**<tr><td><a id="l149"></a><a href="#l149">149</a><td> * Sets the global factory object.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {!goog.net.XmlHttpFactory} factory New global factory object.<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>goog.net.XmlHttp.setGlobalFactory = function(factory) {<tr><td><a id="l153"></a><a href="#l153">153</a><td> goog.net.XmlHttp.factory_ = factory;<tr><td><a id="l154"></a><a href="#l154">154</a><td>};<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>/**<tr><td><a id="l159"></a><a href="#l159">159</a><td> * Default factory to use when creating xhr objects. You probably shouldn&#39;t be<tr><td><a id="l160"></a><a href="#l160">160</a><td> * instantiating this directly, but rather using it via goog.net.XmlHttp.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @constructor<tr><td><a id="l163"></a><a href="#l163">163</a><td> */<tr><td><a id="l164"></a><a href="#l164">164</a><td>goog.net.DefaultXmlHttpFactory = function() {<tr><td><a id="l165"></a><a href="#l165">165</a><td> goog.net.XmlHttpFactory.call(this);<tr><td><a id="l166"></a><a href="#l166">166</a><td>};<tr><td><a id="l167"></a><a href="#l167">167</a><td>goog.inherits(goog.net.DefaultXmlHttpFactory, goog.net.XmlHttpFactory);<tr><td><a id="l168"></a><a href="#l168">168</a><td><tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td>/** @override */<tr><td><a id="l171"></a><a href="#l171">171</a><td>goog.net.DefaultXmlHttpFactory.prototype.createInstance = function() {<tr><td><a id="l172"></a><a href="#l172">172</a><td> var progId = this.getProgId_();<tr><td><a id="l173"></a><a href="#l173">173</a><td> if (progId) {<tr><td><a id="l174"></a><a href="#l174">174</a><td> return new ActiveXObject(progId);<tr><td><a id="l175"></a><a href="#l175">175</a><td> } else {<tr><td><a id="l176"></a><a href="#l176">176</a><td> return new XMLHttpRequest();<tr><td><a id="l177"></a><a href="#l177">177</a><td> }<tr><td><a id="l178"></a><a href="#l178">178</a><td>};<tr><td><a id="l179"></a><a href="#l179">179</a><td><tr><td><a id="l180"></a><a href="#l180">180</a><td><tr><td><a id="l181"></a><a href="#l181">181</a><td>/** @override */<tr><td><a id="l182"></a><a href="#l182">182</a><td>goog.net.DefaultXmlHttpFactory.prototype.internalGetOptions = function() {<tr><td><a id="l183"></a><a href="#l183">183</a><td> var progId = this.getProgId_();<tr><td><a id="l184"></a><a href="#l184">184</a><td> var options = {};<tr><td><a id="l185"></a><a href="#l185">185</a><td> if (progId) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> options[goog.net.XmlHttp.OptionType.USE_NULL_FUNCTION] = true;<tr><td><a id="l187"></a><a href="#l187">187</a><td> options[goog.net.XmlHttp.OptionType.LOCAL_REQUEST_ERROR] = true;<tr><td><a id="l188"></a><a href="#l188">188</a><td> }<tr><td><a id="l189"></a><a href="#l189">189</a><td> return options;<tr><td><a id="l190"></a><a href="#l190">190</a><td>};<tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td>/**<tr><td><a id="l194"></a><a href="#l194">194</a><td> * The ActiveX PROG ID string to use to create xhr&#39;s in IE. Lazily initialized.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @type {string|undefined}<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @private<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>goog.net.DefaultXmlHttpFactory.prototype.ieProgId_;<tr><td><a id="l199"></a><a href="#l199">199</a><td><tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td>/**<tr><td><a id="l202"></a><a href="#l202">202</a><td> * Initialize the private state used by other functions.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {string} The ActiveX PROG ID string to use to create xhr&#39;s in IE.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @private<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>goog.net.DefaultXmlHttpFactory.prototype.getProgId_ = function() {<tr><td><a id="l207"></a><a href="#l207">207</a><td> if (goog.net.XmlHttp.ASSUME_NATIVE_XHR ||<tr><td><a id="l208"></a><a href="#l208">208</a><td> goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR) {<tr><td><a id="l209"></a><a href="#l209">209</a><td> return &#39;&#39;;<tr><td><a id="l210"></a><a href="#l210">210</a><td> }<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td> // The following blog post describes what PROG IDs to use to create the<tr><td><a id="l213"></a><a href="#l213">213</a><td> // XMLHTTP object in Internet Explorer:<tr><td><a id="l214"></a><a href="#l214">214</a><td> // http://blogs.msdn.com/xmlteam/archive/2006/10/23/using-the-right-version-of-msxml-in-internet-explorer.aspx<tr><td><a id="l215"></a><a href="#l215">215</a><td> // However we do not (yet) fully trust that this will be OK for old versions<tr><td><a id="l216"></a><a href="#l216">216</a><td> // of IE on Win9x so we therefore keep the last 2.<tr><td><a id="l217"></a><a href="#l217">217</a><td> if (!this.ieProgId_ &amp;&amp; typeof XMLHttpRequest == &#39;undefined&#39; &amp;&amp;<tr><td><a id="l218"></a><a href="#l218">218</a><td> typeof ActiveXObject != &#39;undefined&#39;) {<tr><td><a id="l219"></a><a href="#l219">219</a><td> // Candidate Active X types.<tr><td><a id="l220"></a><a href="#l220">220</a><td> var ACTIVE_X_IDENTS = [&#39;MSXML2.XMLHTTP.6.0&#39;, &#39;MSXML2.XMLHTTP.3.0&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td> &#39;MSXML2.XMLHTTP&#39;, &#39;Microsoft.XMLHTTP&#39;];<tr><td><a id="l222"></a><a href="#l222">222</a><td> for (var i = 0; i &lt; ACTIVE_X_IDENTS.length; i++) {<tr><td><a id="l223"></a><a href="#l223">223</a><td> var candidate = ACTIVE_X_IDENTS[i];<tr><td><a id="l224"></a><a href="#l224">224</a><td> /** @preserveTry */<tr><td><a id="l225"></a><a href="#l225">225</a><td> try {<tr><td><a id="l226"></a><a href="#l226">226</a><td> new ActiveXObject(candidate);<tr><td><a id="l227"></a><a href="#l227">227</a><td> // NOTE(user): cannot assign progid and return candidate in one line<tr><td><a id="l228"></a><a href="#l228">228</a><td> // because JSCompiler complaings: BUG 658126<tr><td><a id="l229"></a><a href="#l229">229</a><td> this.ieProgId_ = candidate;<tr><td><a id="l230"></a><a href="#l230">230</a><td> return candidate;<tr><td><a id="l231"></a><a href="#l231">231</a><td> } catch (e) {<tr><td><a id="l232"></a><a href="#l232">232</a><td> // do nothing; try next choice<tr><td><a id="l233"></a><a href="#l233">233</a><td> }<tr><td><a id="l234"></a><a href="#l234">234</a><td> }<tr><td><a id="l235"></a><a href="#l235">235</a><td><tr><td><a id="l236"></a><a href="#l236">236</a><td> // couldn&#39;t find any matches<tr><td><a id="l237"></a><a href="#l237">237</a><td> throw Error(&#39;Could not create ActiveXObject. ActiveX might be disabled,&#39; +<tr><td><a id="l238"></a><a href="#l238">238</a><td> &#39; or MSXML might not be installed&#39;);<tr><td><a id="l239"></a><a href="#l239">239</a><td> }<tr><td><a id="l240"></a><a href="#l240">240</a><td><tr><td><a id="l241"></a><a href="#l241">241</a><td> return /** @type {string} */ (this.ieProgId_);<tr><td><a id="l242"></a><a href="#l242">242</a><td>};<tr><td><a id="l243"></a><a href="#l243">243</a><td><tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>//Set the global factory to an instance of the default factory.<tr><td><a id="l246"></a><a href="#l246">246</a><td>goog.net.XmlHttp.setGlobalFactory(new goog.net.DefaultXmlHttpFactory());</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>
@@ -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>xmlhttpfactory.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/net/xmlhttpfactory.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 Interface for a factory for creating XMLHttpRequest objects<tr><td><a id="l17"></a><a href="#l17">17</a><td> * and metadata about them.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<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.net.XmlHttpFactory&#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>/** @suppress {extraRequire} Typedef. */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.net.XhrLike&#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> * Abstract base class for an XmlHttpRequest factory.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @constructor<tr><td><a id="l31"></a><a href="#l31">31</a><td> */<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.net.XmlHttpFactory = function() {<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>/**<tr><td><a id="l37"></a><a href="#l37">37</a><td> * Cache of options - we only actually call internalGetOptions once.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @type {Object}<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @private<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.XmlHttpFactory.prototype.cachedOptions_ = null;<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> * @return {!goog.net.XhrLike.OrNative} A new XhrLike instance.<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.net.XmlHttpFactory.prototype.createInstance = goog.abstractMethod;<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> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a id="l52"></a><a href="#l52">52</a><td> * factory should be used.<tr><td><a id="l53"></a><a href="#l53">53</a><td> */<tr><td><a id="l54"></a><a href="#l54">54</a><td>goog.net.XmlHttpFactory.prototype.getOptions = function() {<tr><td><a id="l55"></a><a href="#l55">55</a><td> return this.cachedOptions_ ||<tr><td><a id="l56"></a><a href="#l56">56</a><td> (this.cachedOptions_ = this.internalGetOptions());<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> * Override this method in subclasses to preserve the caching offered by<tr><td><a id="l62"></a><a href="#l62">62</a><td> * getOptions().<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a id="l64"></a><a href="#l64">64</a><td> * factory should be used.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @protected<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.net.XmlHttpFactory.prototype.internalGetOptions = goog.abstractMethod;</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>
@@ -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>object.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/object/object.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 Utilities for manipulating objects/maps/hashes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.object&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/**<tr><td><a id="l24"></a><a href="#l24">24</a><td> * Calls a function for each element in an object/map/hash.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):?} f The function to call<tr><td><a id="l28"></a><a href="#l28">28</a><td> * for every element. This function takes 3 arguments (the value, the<tr><td><a id="l29"></a><a href="#l29">29</a><td> * key and the object) and the return value is ignored.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @template T,K,V<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.object.forEach = function(obj, f, opt_obj) {<tr><td><a id="l34"></a><a href="#l34">34</a><td> for (var key in obj) {<tr><td><a id="l35"></a><a href="#l35">35</a><td> f.call(opt_obj, obj[key], key, obj);<tr><td><a id="l36"></a><a href="#l36">36</a><td> }<tr><td><a id="l37"></a><a href="#l37">37</a><td>};<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Calls a function for each element in an object/map/hash. If that call returns<tr><td><a id="l42"></a><a href="#l42">42</a><td> * true, adds the element to a new object.<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 {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to call<tr><td><a id="l46"></a><a href="#l46">46</a><td> * for every element. This<tr><td><a id="l47"></a><a href="#l47">47</a><td> * function takes 3 arguments (the value, the key and the object)<tr><td><a id="l48"></a><a href="#l48">48</a><td> * and should return a boolean. If the return value is true the<tr><td><a id="l49"></a><a href="#l49">49</a><td> * element is added to the result object. If it is false the<tr><td><a id="l50"></a><a href="#l50">50</a><td> * element is not included.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {!Object&lt;K,V&gt;} a new object in which only elements that passed the<tr><td><a id="l53"></a><a href="#l53">53</a><td> * test are present.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @template T,K,V<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td>goog.object.filter = function(obj, f, opt_obj) {<tr><td><a id="l57"></a><a href="#l57">57</a><td> var res = {};<tr><td><a id="l58"></a><a href="#l58">58</a><td> for (var key in obj) {<tr><td><a id="l59"></a><a href="#l59">59</a><td> if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l60"></a><a href="#l60">60</a><td> res[key] = obj[key];<tr><td><a id="l61"></a><a href="#l61">61</a><td> }<tr><td><a id="l62"></a><a href="#l62">62</a><td> }<tr><td><a id="l63"></a><a href="#l63">63</a><td> return res;<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * For every element in an object/map/hash calls a function and inserts the<tr><td><a id="l69"></a><a href="#l69">69</a><td> * result into a new object.<tr><td><a id="l70"></a><a href="#l70">70</a><td> *<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):R} f The function to call<tr><td><a id="l73"></a><a href="#l73">73</a><td> * for every element. This function<tr><td><a id="l74"></a><a href="#l74">74</a><td> * takes 3 arguments (the value, the key and the object)<tr><td><a id="l75"></a><a href="#l75">75</a><td> * and should return something. The result will be inserted<tr><td><a id="l76"></a><a href="#l76">76</a><td> * into a new object.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {!Object&lt;K,R&gt;} a new object with the results from f.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @template T,K,V,R<tr><td><a id="l80"></a><a href="#l80">80</a><td> */<tr><td><a id="l81"></a><a href="#l81">81</a><td>goog.object.map = function(obj, f, opt_obj) {<tr><td><a id="l82"></a><a href="#l82">82</a><td> var res = {};<tr><td><a id="l83"></a><a href="#l83">83</a><td> for (var key in obj) {<tr><td><a id="l84"></a><a href="#l84">84</a><td> res[key] = f.call(opt_obj, obj[key], key, obj);<tr><td><a id="l85"></a><a href="#l85">85</a><td> }<tr><td><a id="l86"></a><a href="#l86">86</a><td> return res;<tr><td><a id="l87"></a><a href="#l87">87</a><td>};<tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td>/**<tr><td><a id="l91"></a><a href="#l91">91</a><td> * Calls a function for each element in an object/map/hash. If any<tr><td><a id="l92"></a><a href="#l92">92</a><td> * call returns true, returns true (without checking the rest). If<tr><td><a id="l93"></a><a href="#l93">93</a><td> * all calls return false, returns false.<tr><td><a id="l94"></a><a href="#l94">94</a><td> *<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {Object&lt;K,V&gt;} obj The object to check.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to<tr><td><a id="l97"></a><a href="#l97">97</a><td> * call for every element. This function<tr><td><a id="l98"></a><a href="#l98">98</a><td> * takes 3 arguments (the value, the key and the object) and should<tr><td><a id="l99"></a><a href="#l99">99</a><td> * return a boolean.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {boolean} true if any element passes the test.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @template T,K,V<tr><td><a id="l103"></a><a href="#l103">103</a><td> */<tr><td><a id="l104"></a><a href="#l104">104</a><td>goog.object.some = function(obj, f, opt_obj) {<tr><td><a id="l105"></a><a href="#l105">105</a><td> for (var key in obj) {<tr><td><a id="l106"></a><a href="#l106">106</a><td> if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l107"></a><a href="#l107">107</a><td> return true;<tr><td><a id="l108"></a><a href="#l108">108</a><td> }<tr><td><a id="l109"></a><a href="#l109">109</a><td> }<tr><td><a id="l110"></a><a href="#l110">110</a><td> return false;<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><tr><td><a id="l114"></a><a href="#l114">114</a><td>/**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * Calls a function for each element in an object/map/hash. If<tr><td><a id="l116"></a><a href="#l116">116</a><td> * all calls return true, returns true. If any call returns false, returns<tr><td><a id="l117"></a><a href="#l117">117</a><td> * false at this point and does not continue to check the remaining elements.<tr><td><a id="l118"></a><a href="#l118">118</a><td> *<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @param {Object&lt;K,V&gt;} obj The object to check.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @param {?function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to<tr><td><a id="l121"></a><a href="#l121">121</a><td> * call for every element. This function<tr><td><a id="l122"></a><a href="#l122">122</a><td> * takes 3 arguments (the value, the key and the object) and should<tr><td><a id="l123"></a><a href="#l123">123</a><td> * return a boolean.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @return {boolean} false if any element fails the test.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @template T,K,V<tr><td><a id="l127"></a><a href="#l127">127</a><td> */<tr><td><a id="l128"></a><a href="#l128">128</a><td>goog.object.every = function(obj, f, opt_obj) {<tr><td><a id="l129"></a><a href="#l129">129</a><td> for (var key in obj) {<tr><td><a id="l130"></a><a href="#l130">130</a><td> if (!f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l131"></a><a href="#l131">131</a><td> return false;<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> return true;<tr><td><a id="l135"></a><a href="#l135">135</a><td>};<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> * Returns the number of key-value pairs in the object map.<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {Object} obj The object for which to get the number of key-value<tr><td><a id="l142"></a><a href="#l142">142</a><td> * pairs.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @return {number} The number of key-value pairs in the object map.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>goog.object.getCount = function(obj) {<tr><td><a id="l146"></a><a href="#l146">146</a><td> // JS1.5 has __count__ but it has been deprecated so it raises a warning...<tr><td><a id="l147"></a><a href="#l147">147</a><td> // in other words do not use. Also __count__ only includes the fields on the<tr><td><a id="l148"></a><a href="#l148">148</a><td> // actual object and not in the prototype chain.<tr><td><a id="l149"></a><a href="#l149">149</a><td> var rv = 0;<tr><td><a id="l150"></a><a href="#l150">150</a><td> for (var key in obj) {<tr><td><a id="l151"></a><a href="#l151">151</a><td> rv++;<tr><td><a id="l152"></a><a href="#l152">152</a><td> }<tr><td><a id="l153"></a><a href="#l153">153</a><td> return rv;<tr><td><a id="l154"></a><a href="#l154">154</a><td>};<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td>/**<tr><td><a id="l158"></a><a href="#l158">158</a><td> * Returns one key from the object map, if any exists.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * For map literals the returned key will be the first one in most of the<tr><td><a id="l160"></a><a href="#l160">160</a><td> * browsers (a know exception is Konqueror).<tr><td><a id="l161"></a><a href="#l161">161</a><td> *<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {Object} obj The object to pick a key from.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @return {string|undefined} The key or undefined if the object is empty.<tr><td><a id="l164"></a><a href="#l164">164</a><td> */<tr><td><a id="l165"></a><a href="#l165">165</a><td>goog.object.getAnyKey = function(obj) {<tr><td><a id="l166"></a><a href="#l166">166</a><td> for (var key in obj) {<tr><td><a id="l167"></a><a href="#l167">167</a><td> return key;<tr><td><a id="l168"></a><a href="#l168">168</a><td> }<tr><td><a id="l169"></a><a href="#l169">169</a><td>};<tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td><tr><td><a id="l172"></a><a href="#l172">172</a><td>/**<tr><td><a id="l173"></a><a href="#l173">173</a><td> * Returns one value from the object map, if any exists.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * For map literals the returned value will be the first one in most of the<tr><td><a id="l175"></a><a href="#l175">175</a><td> * browsers (a know exception is Konqueror).<tr><td><a id="l176"></a><a href="#l176">176</a><td> *<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @param {Object&lt;K,V&gt;} obj The object to pick a value from.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {V|undefined} The value or undefined if the object is empty.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @template K,V<tr><td><a id="l180"></a><a href="#l180">180</a><td> */<tr><td><a id="l181"></a><a href="#l181">181</a><td>goog.object.getAnyValue = function(obj) {<tr><td><a id="l182"></a><a href="#l182">182</a><td> for (var key in obj) {<tr><td><a id="l183"></a><a href="#l183">183</a><td> return obj[key];<tr><td><a id="l184"></a><a href="#l184">184</a><td> }<tr><td><a id="l185"></a><a href="#l185">185</a><td>};<tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td><tr><td><a id="l188"></a><a href="#l188">188</a><td>/**<tr><td><a id="l189"></a><a href="#l189">189</a><td> * Whether the object/hash/map contains the given object as a value.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * An alias for goog.object.containsValue(obj, val).<tr><td><a id="l191"></a><a href="#l191">191</a><td> *<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @param {Object&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {V} val The object for which to check.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @return {boolean} true if val is present.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @template K,V<tr><td><a id="l196"></a><a href="#l196">196</a><td> */<tr><td><a id="l197"></a><a href="#l197">197</a><td>goog.object.contains = function(obj, val) {<tr><td><a id="l198"></a><a href="#l198">198</a><td> return goog.object.containsValue(obj, val);<tr><td><a id="l199"></a><a href="#l199">199</a><td>};<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * Returns the values of the object/map/hash.<tr><td><a id="l204"></a><a href="#l204">204</a><td> *<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {Object&lt;K,V&gt;} obj The object from which to get the values.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {!Array&lt;V&gt;} The values in the object/map/hash.<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @template K,V<tr><td><a id="l208"></a><a href="#l208">208</a><td> */<tr><td><a id="l209"></a><a href="#l209">209</a><td>goog.object.getValues = function(obj) {<tr><td><a id="l210"></a><a href="#l210">210</a><td> var res = [];<tr><td><a id="l211"></a><a href="#l211">211</a><td> var i = 0;<tr><td><a id="l212"></a><a href="#l212">212</a><td> for (var key in obj) {<tr><td><a id="l213"></a><a href="#l213">213</a><td> res[i++] = obj[key];<tr><td><a id="l214"></a><a href="#l214">214</a><td> }<tr><td><a id="l215"></a><a href="#l215">215</a><td> return res;<tr><td><a id="l216"></a><a href="#l216">216</a><td>};<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td><tr><td><a id="l219"></a><a href="#l219">219</a><td>/**<tr><td><a id="l220"></a><a href="#l220">220</a><td> * Returns the keys of the object/map/hash.<tr><td><a id="l221"></a><a href="#l221">221</a><td> *<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {Object} obj The object from which to get the keys.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!Array&lt;string&gt;} Array of property keys.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>goog.object.getKeys = function(obj) {<tr><td><a id="l226"></a><a href="#l226">226</a><td> var res = [];<tr><td><a id="l227"></a><a href="#l227">227</a><td> var i = 0;<tr><td><a id="l228"></a><a href="#l228">228</a><td> for (var key in obj) {<tr><td><a id="l229"></a><a href="#l229">229</a><td> res[i++] = key;<tr><td><a id="l230"></a><a href="#l230">230</a><td> }<tr><td><a id="l231"></a><a href="#l231">231</a><td> return res;<tr><td><a id="l232"></a><a href="#l232">232</a><td>};<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td><tr><td><a id="l235"></a><a href="#l235">235</a><td>/**<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Get a value from an object multiple levels deep. This is useful for<tr><td><a id="l237"></a><a href="#l237">237</a><td> * pulling values from deeply nested objects, such as JSON responses.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Example usage: getValueByKeys(jsonObj, &#39;foo&#39;, &#39;entries&#39;, 3)<tr><td><a id="l239"></a><a href="#l239">239</a><td> *<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!Object} obj An object to get the value from. Can be array-like.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {...(string|number|!Array&lt;number|string&gt;)} var_args A number of keys<tr><td><a id="l242"></a><a href="#l242">242</a><td> * (as strings, or numbers, for array-like objects). Can also be<tr><td><a id="l243"></a><a href="#l243">243</a><td> * specified as a single array of keys.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @return {*} The resulting value. If, at any point, the value for a key<tr><td><a id="l245"></a><a href="#l245">245</a><td> * is undefined, returns undefined.<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>goog.object.getValueByKeys = function(obj, var_args) {<tr><td><a id="l248"></a><a href="#l248">248</a><td> var isArrayLike = goog.isArrayLike(var_args);<tr><td><a id="l249"></a><a href="#l249">249</a><td> var keys = isArrayLike ? var_args : arguments;<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td> // Start with the 2nd parameter for the variable parameters syntax.<tr><td><a id="l252"></a><a href="#l252">252</a><td> for (var i = isArrayLike ? 0 : 1; i &lt; keys.length; i++) {<tr><td><a id="l253"></a><a href="#l253">253</a><td> obj = obj[keys[i]];<tr><td><a id="l254"></a><a href="#l254">254</a><td> if (!goog.isDef(obj)) {<tr><td><a id="l255"></a><a href="#l255">255</a><td> break;<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> return obj;<tr><td><a id="l260"></a><a href="#l260">260</a><td>};<tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>/**<tr><td><a id="l264"></a><a href="#l264">264</a><td> * Whether the object/map/hash contains the given key.<tr><td><a id="l265"></a><a href="#l265">265</a><td> *<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @param {Object} obj The object in which to look for key.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @param {?} key The key for which to check.<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @return {boolean} true If the map contains the key.<tr><td><a id="l269"></a><a href="#l269">269</a><td> */<tr><td><a id="l270"></a><a href="#l270">270</a><td>goog.object.containsKey = function(obj, key) {<tr><td><a id="l271"></a><a href="#l271">271</a><td> return obj !== null &amp;&amp; key in obj;<tr><td><a id="l272"></a><a href="#l272">272</a><td>};<tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td><tr><td><a id="l275"></a><a href="#l275">275</a><td>/**<tr><td><a id="l276"></a><a href="#l276">276</a><td> * Whether the object/map/hash contains the given value. This is O(n).<tr><td><a id="l277"></a><a href="#l277">277</a><td> *<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {Object&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {V} val The value for which to check.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {boolean} true If the map contains the value.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @template K,V<tr><td><a id="l282"></a><a href="#l282">282</a><td> */<tr><td><a id="l283"></a><a href="#l283">283</a><td>goog.object.containsValue = function(obj, val) {<tr><td><a id="l284"></a><a href="#l284">284</a><td> for (var key in obj) {<tr><td><a id="l285"></a><a href="#l285">285</a><td> if (obj[key] == val) {<tr><td><a id="l286"></a><a href="#l286">286</a><td> return true;<tr><td><a id="l287"></a><a href="#l287">287</a><td> }<tr><td><a id="l288"></a><a href="#l288">288</a><td> }<tr><td><a id="l289"></a><a href="#l289">289</a><td> return false;<tr><td><a id="l290"></a><a href="#l290">290</a><td>};<tr><td><a id="l291"></a><a href="#l291">291</a><td><tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td>/**<tr><td><a id="l294"></a><a href="#l294">294</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a id="l295"></a><a href="#l295">295</a><td> * returns its key.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {Object&lt;K,V&gt;} obj The object to search in.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {function(this:T,V,string,Object&lt;K,V&gt;):boolean} f The<tr><td><a id="l298"></a><a href="#l298">298</a><td> * function to call for every element. Takes 3 arguments (the value,<tr><td><a id="l299"></a><a href="#l299">299</a><td> * the key and the object) and should return a boolean.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @return {string|undefined} The key of an element for which the function<tr><td><a id="l302"></a><a href="#l302">302</a><td> * returns true or undefined if no such element is found.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @template T,K,V<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>goog.object.findKey = function(obj, f, opt_this) {<tr><td><a id="l306"></a><a href="#l306">306</a><td> for (var key in obj) {<tr><td><a id="l307"></a><a href="#l307">307</a><td> if (f.call(opt_this, obj[key], key, obj)) {<tr><td><a id="l308"></a><a href="#l308">308</a><td> return key;<tr><td><a id="l309"></a><a href="#l309">309</a><td> }<tr><td><a id="l310"></a><a href="#l310">310</a><td> }<tr><td><a id="l311"></a><a href="#l311">311</a><td> return undefined;<tr><td><a id="l312"></a><a href="#l312">312</a><td>};<tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td><tr><td><a id="l315"></a><a href="#l315">315</a><td>/**<tr><td><a id="l316"></a><a href="#l316">316</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a id="l317"></a><a href="#l317">317</a><td> * returns its value.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @param {Object&lt;K,V&gt;} obj The object to search in.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {function(this:T,V,string,Object&lt;K,V&gt;):boolean} f The function<tr><td><a id="l320"></a><a href="#l320">320</a><td> * to call for every element. Takes 3 arguments (the value, the key<tr><td><a id="l321"></a><a href="#l321">321</a><td> * and the object) and should return a boolean.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {V} The value of an element for which the function returns true or<tr><td><a id="l324"></a><a href="#l324">324</a><td> * undefined if no such element is found.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @template T,K,V<tr><td><a id="l326"></a><a href="#l326">326</a><td> */<tr><td><a id="l327"></a><a href="#l327">327</a><td>goog.object.findValue = function(obj, f, opt_this) {<tr><td><a id="l328"></a><a href="#l328">328</a><td> var key = goog.object.findKey(obj, f, opt_this);<tr><td><a id="l329"></a><a href="#l329">329</a><td> return key &amp;&amp; obj[key];<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>/**<tr><td><a id="l334"></a><a href="#l334">334</a><td> * Whether the object/map/hash is empty.<tr><td><a id="l335"></a><a href="#l335">335</a><td> *<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @param {Object} obj The object to test.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @return {boolean} true if obj is empty.<tr><td><a id="l338"></a><a href="#l338">338</a><td> */<tr><td><a id="l339"></a><a href="#l339">339</a><td>goog.object.isEmpty = function(obj) {<tr><td><a id="l340"></a><a href="#l340">340</a><td> for (var key in obj) {<tr><td><a id="l341"></a><a href="#l341">341</a><td> return false;<tr><td><a id="l342"></a><a href="#l342">342</a><td> }<tr><td><a id="l343"></a><a href="#l343">343</a><td> return true;<tr><td><a id="l344"></a><a href="#l344">344</a><td>};<tr><td><a id="l345"></a><a href="#l345">345</a><td><tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td>/**<tr><td><a id="l348"></a><a href="#l348">348</a><td> * Removes all key value pairs from the object/map/hash.<tr><td><a id="l349"></a><a href="#l349">349</a><td> *<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {Object} obj The object to clear.<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>goog.object.clear = function(obj) {<tr><td><a id="l353"></a><a href="#l353">353</a><td> for (var i in obj) {<tr><td><a id="l354"></a><a href="#l354">354</a><td> delete obj[i];<tr><td><a id="l355"></a><a href="#l355">355</a><td> }<tr><td><a id="l356"></a><a href="#l356">356</a><td>};<tr><td><a id="l357"></a><a href="#l357">357</a><td><tr><td><a id="l358"></a><a href="#l358">358</a><td><tr><td><a id="l359"></a><a href="#l359">359</a><td>/**<tr><td><a id="l360"></a><a href="#l360">360</a><td> * Removes a key-value pair based on the key.<tr><td><a id="l361"></a><a href="#l361">361</a><td> *<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {Object} obj The object from which to remove the key.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @param {*} key The key to remove.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {boolean} Whether an element was removed.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>goog.object.remove = function(obj, key) {<tr><td><a id="l367"></a><a href="#l367">367</a><td> var rv;<tr><td><a id="l368"></a><a href="#l368">368</a><td> if (rv = key in /** @type {!Object} */ (obj)) {<tr><td><a id="l369"></a><a href="#l369">369</a><td> delete obj[key];<tr><td><a id="l370"></a><a href="#l370">370</a><td> }<tr><td><a id="l371"></a><a href="#l371">371</a><td> return rv;<tr><td><a id="l372"></a><a href="#l372">372</a><td>};<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> * Adds a key-value pair to the object. Throws an exception if the key is<tr><td><a id="l377"></a><a href="#l377">377</a><td> * already in use. Use set if you want to change an existing pair.<tr><td><a id="l378"></a><a href="#l378">378</a><td> *<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {string} key The key to add.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {V} val The value to add.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @template K,V<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.object.add = function(obj, key, val) {<tr><td><a id="l385"></a><a href="#l385">385</a><td> if (obj !== null &amp;&amp; key in obj) {<tr><td><a id="l386"></a><a href="#l386">386</a><td> throw Error(&#39;The object already contains the key &quot;&#39; + key + &#39;&quot;&#39;);<tr><td><a id="l387"></a><a href="#l387">387</a><td> }<tr><td><a id="l388"></a><a href="#l388">388</a><td> goog.object.set(obj, key, val);<tr><td><a id="l389"></a><a href="#l389">389</a><td>};<tr><td><a id="l390"></a><a href="#l390">390</a><td><tr><td><a id="l391"></a><a href="#l391">391</a><td><tr><td><a id="l392"></a><a href="#l392">392</a><td>/**<tr><td><a id="l393"></a><a href="#l393">393</a><td> * Returns the value for the given key.<tr><td><a id="l394"></a><a href="#l394">394</a><td> *<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @param {Object&lt;K,V&gt;} obj The object from which to get the value.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {string} key The key for which to get the value.<tr><td><a id="l397"></a><a href="#l397">397</a><td> * @param {R=} opt_val The value to return if no item is found for the given<tr><td><a id="l398"></a><a href="#l398">398</a><td> * key (default is undefined).<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @return {V|R|undefined} The value for the given key.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @template K,V,R<tr><td><a id="l401"></a><a href="#l401">401</a><td> */<tr><td><a id="l402"></a><a href="#l402">402</a><td>goog.object.get = function(obj, key, opt_val) {<tr><td><a id="l403"></a><a href="#l403">403</a><td> if (obj !== null &amp;&amp; key in obj) {<tr><td><a id="l404"></a><a href="#l404">404</a><td> return obj[key];<tr><td><a id="l405"></a><a href="#l405">405</a><td> }<tr><td><a id="l406"></a><a href="#l406">406</a><td> return opt_val;<tr><td><a id="l407"></a><a href="#l407">407</a><td>};<tr><td><a id="l408"></a><a href="#l408">408</a><td><tr><td><a id="l409"></a><a href="#l409">409</a><td><tr><td><a id="l410"></a><a href="#l410">410</a><td>/**<tr><td><a id="l411"></a><a href="#l411">411</a><td> * Adds a key-value pair to the object/map/hash.<tr><td><a id="l412"></a><a href="#l412">412</a><td> *<tr><td><a id="l413"></a><a href="#l413">413</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l414"></a><a href="#l414">414</a><td> * @param {string} key The key to add.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @param {V} value The value to add.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @template K,V<tr><td><a id="l417"></a><a href="#l417">417</a><td> */<tr><td><a id="l418"></a><a href="#l418">418</a><td>goog.object.set = function(obj, key, value) {<tr><td><a id="l419"></a><a href="#l419">419</a><td> obj[key] = value;<tr><td><a id="l420"></a><a href="#l420">420</a><td>};<tr><td><a id="l421"></a><a href="#l421">421</a><td><tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td>/**<tr><td><a id="l424"></a><a href="#l424">424</a><td> * Adds a key-value pair to the object/map/hash if it doesn&#39;t exist yet.<tr><td><a id="l425"></a><a href="#l425">425</a><td> *<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @param {string} key The key to add.<tr><td><a id="l428"></a><a href="#l428">428</a><td> * @param {V} value The value to add if the key wasn&#39;t present.<tr><td><a id="l429"></a><a href="#l429">429</a><td> * @return {V} The value of the entry at the end of the function.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @template K,V<tr><td><a id="l431"></a><a href="#l431">431</a><td> */<tr><td><a id="l432"></a><a href="#l432">432</a><td>goog.object.setIfUndefined = function(obj, key, value) {<tr><td><a id="l433"></a><a href="#l433">433</a><td> return key in /** @type {!Object} */ (obj) ? obj[key] : (obj[key] = value);<tr><td><a id="l434"></a><a href="#l434">434</a><td>};<tr><td><a id="l435"></a><a href="#l435">435</a><td><tr><td><a id="l436"></a><a href="#l436">436</a><td><tr><td><a id="l437"></a><a href="#l437">437</a><td>/**<tr><td><a id="l438"></a><a href="#l438">438</a><td> * Sets a key and value to an object if the key is not set. The value will be<tr><td><a id="l439"></a><a href="#l439">439</a><td> * the return value of the given function. If the key already exists, the<tr><td><a id="l440"></a><a href="#l440">440</a><td> * object will not be changed and the function will not be called (the function<tr><td><a id="l441"></a><a href="#l441">441</a><td> * will be lazily evaluated -- only called if necessary).<tr><td><a id="l442"></a><a href="#l442">442</a><td> *<tr><td><a id="l443"></a><a href="#l443">443</a><td> * This function is particularly useful for use with a map used a as a cache.<tr><td><a id="l444"></a><a href="#l444">444</a><td> *<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @param {!Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @param {string} key The key to add.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {function():V} f The value to add if the key wasn&#39;t present.<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @return {V} The value of the entry at the end of the function.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @template K,V<tr><td><a id="l450"></a><a href="#l450">450</a><td> */<tr><td><a id="l451"></a><a href="#l451">451</a><td>goog.object.setWithReturnValueIfNotSet = function(obj, key, f) {<tr><td><a id="l452"></a><a href="#l452">452</a><td> if (key in obj) {<tr><td><a id="l453"></a><a href="#l453">453</a><td> return obj[key];<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> var val = f();<tr><td><a id="l457"></a><a href="#l457">457</a><td> obj[key] = val;<tr><td><a id="l458"></a><a href="#l458">458</a><td> return val;<tr><td><a id="l459"></a><a href="#l459">459</a><td>};<tr><td><a id="l460"></a><a href="#l460">460</a><td><tr><td><a id="l461"></a><a href="#l461">461</a><td><tr><td><a id="l462"></a><a href="#l462">462</a><td>/**<tr><td><a id="l463"></a><a href="#l463">463</a><td> * Compares two objects for equality using === on the values.<tr><td><a id="l464"></a><a href="#l464">464</a><td> *<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @param {!Object&lt;K,V&gt;} a<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @param {!Object&lt;K,V&gt;} b<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @return {boolean}<tr><td><a id="l468"></a><a href="#l468">468</a><td> * @template K,V<tr><td><a id="l469"></a><a href="#l469">469</a><td> */<tr><td><a id="l470"></a><a href="#l470">470</a><td>goog.object.equals = function(a, b) {<tr><td><a id="l471"></a><a href="#l471">471</a><td> for (var k in a) {<tr><td><a id="l472"></a><a href="#l472">472</a><td> if (!(k in b) || a[k] !== b[k]) {<tr><td><a id="l473"></a><a href="#l473">473</a><td> return false;<tr><td><a id="l474"></a><a href="#l474">474</a><td> }<tr><td><a id="l475"></a><a href="#l475">475</a><td> }<tr><td><a id="l476"></a><a href="#l476">476</a><td> for (var k in b) {<tr><td><a id="l477"></a><a href="#l477">477</a><td> if (!(k in a)) {<tr><td><a id="l478"></a><a href="#l478">478</a><td> return false;<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> return true;<tr><td><a id="l482"></a><a href="#l482">482</a><td>};<tr><td><a id="l483"></a><a href="#l483">483</a><td><tr><td><a id="l484"></a><a href="#l484">484</a><td><tr><td><a id="l485"></a><a href="#l485">485</a><td>/**<tr><td><a id="l486"></a><a href="#l486">486</a><td> * Does a flat clone of the object.<tr><td><a id="l487"></a><a href="#l487">487</a><td> *<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @param {Object&lt;K,V&gt;} obj Object to clone.<tr><td><a id="l489"></a><a href="#l489">489</a><td> * @return {!Object&lt;K,V&gt;} Clone of the input object.<tr><td><a id="l490"></a><a href="#l490">490</a><td> * @template K,V<tr><td><a id="l491"></a><a href="#l491">491</a><td> */<tr><td><a id="l492"></a><a href="#l492">492</a><td>goog.object.clone = function(obj) {<tr><td><a id="l493"></a><a href="#l493">493</a><td> // We cannot use the prototype trick because a lot of methods depend on where<tr><td><a id="l494"></a><a href="#l494">494</a><td> // the actual key is set.<tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td> var res = {};<tr><td><a id="l497"></a><a href="#l497">497</a><td> for (var key in obj) {<tr><td><a id="l498"></a><a href="#l498">498</a><td> res[key] = obj[key];<tr><td><a id="l499"></a><a href="#l499">499</a><td> }<tr><td><a id="l500"></a><a href="#l500">500</a><td> return res;<tr><td><a id="l501"></a><a href="#l501">501</a><td> // We could also use goog.mixin but I wanted this to be independent from that.<tr><td><a id="l502"></a><a href="#l502">502</a><td>};<tr><td><a id="l503"></a><a href="#l503">503</a><td><tr><td><a id="l504"></a><a href="#l504">504</a><td><tr><td><a id="l505"></a><a href="#l505">505</a><td>/**<tr><td><a id="l506"></a><a href="#l506">506</a><td> * Clones a value. The input may be an Object, Array, or basic type. Objects and<tr><td><a id="l507"></a><a href="#l507">507</a><td> * arrays will be cloned recursively.<tr><td><a id="l508"></a><a href="#l508">508</a><td> *<tr><td><a id="l509"></a><a href="#l509">509</a><td> * WARNINGS:<tr><td><a id="l510"></a><a href="#l510">510</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; does not detect reference loops. Objects<tr><td><a id="l511"></a><a href="#l511">511</a><td> * that refer to themselves will cause infinite recursion.<tr><td><a id="l512"></a><a href="#l512">512</a><td> *<tr><td><a id="l513"></a><a href="#l513">513</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; is unaware of unique identifiers, and<tr><td><a id="l514"></a><a href="#l514">514</a><td> * copies UIDs created by &lt;code&gt;getUid&lt;/code&gt; into cloned results.<tr><td><a id="l515"></a><a href="#l515">515</a><td> *<tr><td><a id="l516"></a><a href="#l516">516</a><td> * @param {*} obj The value to clone.<tr><td><a id="l517"></a><a href="#l517">517</a><td> * @return {*} A clone of the input value.<tr><td><a id="l518"></a><a href="#l518">518</a><td> */<tr><td><a id="l519"></a><a href="#l519">519</a><td>goog.object.unsafeClone = function(obj) {<tr><td><a id="l520"></a><a href="#l520">520</a><td> var type = goog.typeOf(obj);<tr><td><a id="l521"></a><a href="#l521">521</a><td> if (type == &#39;object&#39; || type == &#39;array&#39;) {<tr><td><a id="l522"></a><a href="#l522">522</a><td> if (goog.isFunction(obj.clone)) {<tr><td><a id="l523"></a><a href="#l523">523</a><td> return obj.clone();<tr><td><a id="l524"></a><a href="#l524">524</a><td> }<tr><td><a id="l525"></a><a href="#l525">525</a><td> var clone = type == &#39;array&#39; ? [] : {};<tr><td><a id="l526"></a><a href="#l526">526</a><td> for (var key in obj) {<tr><td><a id="l527"></a><a href="#l527">527</a><td> clone[key] = goog.object.unsafeClone(obj[key]);<tr><td><a id="l528"></a><a href="#l528">528</a><td> }<tr><td><a id="l529"></a><a href="#l529">529</a><td> return clone;<tr><td><a id="l530"></a><a href="#l530">530</a><td> }<tr><td><a id="l531"></a><a href="#l531">531</a><td><tr><td><a id="l532"></a><a href="#l532">532</a><td> return obj;<tr><td><a id="l533"></a><a href="#l533">533</a><td>};<tr><td><a id="l534"></a><a href="#l534">534</a><td><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> * Returns a new object in which all the keys and values are interchanged<tr><td><a id="l538"></a><a href="#l538">538</a><td> * (keys become values and values become keys). If multiple keys map to the<tr><td><a id="l539"></a><a href="#l539">539</a><td> * same value, the chosen transposed value is implementation-dependent.<tr><td><a id="l540"></a><a href="#l540">540</a><td> *<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @param {Object} obj The object to transpose.<tr><td><a id="l542"></a><a href="#l542">542</a><td> * @return {!Object} The transposed object.<tr><td><a id="l543"></a><a href="#l543">543</a><td> */<tr><td><a id="l544"></a><a href="#l544">544</a><td>goog.object.transpose = function(obj) {<tr><td><a id="l545"></a><a href="#l545">545</a><td> var transposed = {};<tr><td><a id="l546"></a><a href="#l546">546</a><td> for (var key in obj) {<tr><td><a id="l547"></a><a href="#l547">547</a><td> transposed[obj[key]] = key;<tr><td><a id="l548"></a><a href="#l548">548</a><td> }<tr><td><a id="l549"></a><a href="#l549">549</a><td> return transposed;<tr><td><a id="l550"></a><a href="#l550">550</a><td>};<tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td><tr><td><a id="l553"></a><a href="#l553">553</a><td>/**<tr><td><a id="l554"></a><a href="#l554">554</a><td> * The names of the fields that are defined on Object.prototype.<tr><td><a id="l555"></a><a href="#l555">555</a><td> * @type {Array&lt;string&gt;}<tr><td><a id="l556"></a><a href="#l556">556</a><td> * @private<tr><td><a id="l557"></a><a href="#l557">557</a><td> */<tr><td><a id="l558"></a><a href="#l558">558</a><td>goog.object.PROTOTYPE_FIELDS_ = [<tr><td><a id="l559"></a><a href="#l559">559</a><td> &#39;constructor&#39;,<tr><td><a id="l560"></a><a href="#l560">560</a><td> &#39;hasOwnProperty&#39;,<tr><td><a id="l561"></a><a href="#l561">561</a><td> &#39;isPrototypeOf&#39;,<tr><td><a id="l562"></a><a href="#l562">562</a><td> &#39;propertyIsEnumerable&#39;,<tr><td><a id="l563"></a><a href="#l563">563</a><td> &#39;toLocaleString&#39;,<tr><td><a id="l564"></a><a href="#l564">564</a><td> &#39;toString&#39;,<tr><td><a id="l565"></a><a href="#l565">565</a><td> &#39;valueOf&#39;<tr><td><a id="l566"></a><a href="#l566">566</a><td>];<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> * Extends an object with another object.<tr><td><a id="l571"></a><a href="#l571">571</a><td> * This operates &#39;in-place&#39;; it does not create a new Object.<tr><td><a id="l572"></a><a href="#l572">572</a><td> *<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Example:<tr><td><a id="l574"></a><a href="#l574">574</a><td> * var o = {};<tr><td><a id="l575"></a><a href="#l575">575</a><td> * goog.object.extend(o, {a: 0, b: 1});<tr><td><a id="l576"></a><a href="#l576">576</a><td> * o; // {a: 0, b: 1}<tr><td><a id="l577"></a><a href="#l577">577</a><td> * goog.object.extend(o, {b: 2, c: 3});<tr><td><a id="l578"></a><a href="#l578">578</a><td> * o; // {a: 0, b: 2, c: 3}<tr><td><a id="l579"></a><a href="#l579">579</a><td> *<tr><td><a id="l580"></a><a href="#l580">580</a><td> * @param {Object} target The object to modify. Existing properties will be<tr><td><a id="l581"></a><a href="#l581">581</a><td> * overwritten if they are also present in one of the objects in<tr><td><a id="l582"></a><a href="#l582">582</a><td> * {@code var_args}.<tr><td><a id="l583"></a><a href="#l583">583</a><td> * @param {...Object} var_args The objects from which values will be copied.<tr><td><a id="l584"></a><a href="#l584">584</a><td> */<tr><td><a id="l585"></a><a href="#l585">585</a><td>goog.object.extend = function(target, var_args) {<tr><td><a id="l586"></a><a href="#l586">586</a><td> var key, source;<tr><td><a id="l587"></a><a href="#l587">587</a><td> for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l588"></a><a href="#l588">588</a><td> source = arguments[i];<tr><td><a id="l589"></a><a href="#l589">589</a><td> for (key in source) {<tr><td><a id="l590"></a><a href="#l590">590</a><td> target[key] = source[key];<tr><td><a id="l591"></a><a href="#l591">591</a><td> }<tr><td><a id="l592"></a><a href="#l592">592</a><td><tr><td><a id="l593"></a><a href="#l593">593</a><td> // For IE the for-in-loop does not contain any properties that are not<tr><td><a id="l594"></a><a href="#l594">594</a><td> // enumerable on the prototype object (for example isPrototypeOf from<tr><td><a id="l595"></a><a href="#l595">595</a><td> // Object.prototype) and it will also not include &#39;replace&#39; on objects that<tr><td><a id="l596"></a><a href="#l596">596</a><td> // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a id="l597"></a><a href="#l597">597</a><td> // extend anything except Object).<tr><td><a id="l598"></a><a href="#l598">598</a><td><tr><td><a id="l599"></a><a href="#l599">599</a><td> for (var j = 0; j &lt; goog.object.PROTOTYPE_FIELDS_.length; j++) {<tr><td><a id="l600"></a><a href="#l600">600</a><td> key = goog.object.PROTOTYPE_FIELDS_[j];<tr><td><a id="l601"></a><a href="#l601">601</a><td> if (Object.prototype.hasOwnProperty.call(source, key)) {<tr><td><a id="l602"></a><a href="#l602">602</a><td> target[key] = source[key];<tr><td><a id="l603"></a><a href="#l603">603</a><td> }<tr><td><a id="l604"></a><a href="#l604">604</a><td> }<tr><td><a id="l605"></a><a href="#l605">605</a><td> }<tr><td><a id="l606"></a><a href="#l606">606</a><td>};<tr><td><a id="l607"></a><a href="#l607">607</a><td><tr><td><a id="l608"></a><a href="#l608">608</a><td><tr><td><a id="l609"></a><a href="#l609">609</a><td>/**<tr><td><a id="l610"></a><a href="#l610">610</a><td> * Creates a new object built from the key-value pairs provided as arguments.<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a id="l612"></a><a href="#l612">612</a><td> * then this is used as the arguments, otherwise even arguments are used as<tr><td><a id="l613"></a><a href="#l613">613</a><td> * the property names and odd arguments are used as the property values.<tr><td><a id="l614"></a><a href="#l614">614</a><td> * @return {!Object} The new object.<tr><td><a id="l615"></a><a href="#l615">615</a><td> * @throws {Error} If there are uneven number of arguments or there is only one<tr><td><a id="l616"></a><a href="#l616">616</a><td> * non array argument.<tr><td><a id="l617"></a><a href="#l617">617</a><td> */<tr><td><a id="l618"></a><a href="#l618">618</a><td>goog.object.create = function(var_args) {<tr><td><a id="l619"></a><a href="#l619">619</a><td> var argLength = arguments.length;<tr><td><a id="l620"></a><a href="#l620">620</a><td> if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a id="l621"></a><a href="#l621">621</a><td> return goog.object.create.apply(null, arguments[0]);<tr><td><a id="l622"></a><a href="#l622">622</a><td> }<tr><td><a id="l623"></a><a href="#l623">623</a><td><tr><td><a id="l624"></a><a href="#l624">624</a><td> if (argLength % 2) {<tr><td><a id="l625"></a><a href="#l625">625</a><td> throw Error(&#39;Uneven number of arguments&#39;);<tr><td><a id="l626"></a><a href="#l626">626</a><td> }<tr><td><a id="l627"></a><a href="#l627">627</a><td><tr><td><a id="l628"></a><a href="#l628">628</a><td> var rv = {};<tr><td><a id="l629"></a><a href="#l629">629</a><td> for (var i = 0; i &lt; argLength; i += 2) {<tr><td><a id="l630"></a><a href="#l630">630</a><td> rv[arguments[i]] = arguments[i + 1];<tr><td><a id="l631"></a><a href="#l631">631</a><td> }<tr><td><a id="l632"></a><a href="#l632">632</a><td> return rv;<tr><td><a id="l633"></a><a href="#l633">633</a><td>};<tr><td><a id="l634"></a><a href="#l634">634</a><td><tr><td><a id="l635"></a><a href="#l635">635</a><td><tr><td><a id="l636"></a><a href="#l636">636</a><td>/**<tr><td><a id="l637"></a><a href="#l637">637</a><td> * Creates a new object where the property names come from the arguments but<tr><td><a id="l638"></a><a href="#l638">638</a><td> * the value is always set to true<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a id="l640"></a><a href="#l640">640</a><td> * then this is used as the arguments, otherwise the arguments are used<tr><td><a id="l641"></a><a href="#l641">641</a><td> * as the property names.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {!Object} The new object.<tr><td><a id="l643"></a><a href="#l643">643</a><td> */<tr><td><a id="l644"></a><a href="#l644">644</a><td>goog.object.createSet = function(var_args) {<tr><td><a id="l645"></a><a href="#l645">645</a><td> var argLength = arguments.length;<tr><td><a id="l646"></a><a href="#l646">646</a><td> if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a id="l647"></a><a href="#l647">647</a><td> return goog.object.createSet.apply(null, arguments[0]);<tr><td><a id="l648"></a><a href="#l648">648</a><td> }<tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td> var rv = {};<tr><td><a id="l651"></a><a href="#l651">651</a><td> for (var i = 0; i &lt; argLength; i++) {<tr><td><a id="l652"></a><a href="#l652">652</a><td> rv[arguments[i]] = true;<tr><td><a id="l653"></a><a href="#l653">653</a><td> }<tr><td><a id="l654"></a><a href="#l654">654</a><td> return rv;<tr><td><a id="l655"></a><a href="#l655">655</a><td>};<tr><td><a id="l656"></a><a href="#l656">656</a><td><tr><td><a id="l657"></a><a href="#l657">657</a><td><tr><td><a id="l658"></a><a href="#l658">658</a><td>/**<tr><td><a id="l659"></a><a href="#l659">659</a><td> * Creates an immutable view of the underlying object, if the browser<tr><td><a id="l660"></a><a href="#l660">660</a><td> * supports immutable objects.<tr><td><a id="l661"></a><a href="#l661">661</a><td> *<tr><td><a id="l662"></a><a href="#l662">662</a><td> * In default mode, writes to this view will fail silently. In strict mode,<tr><td><a id="l663"></a><a href="#l663">663</a><td> * they will throw an error.<tr><td><a id="l664"></a><a href="#l664">664</a><td> *<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @param {!Object&lt;K,V&gt;} obj An object.<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @return {!Object&lt;K,V&gt;} An immutable view of that object, or the<tr><td><a id="l667"></a><a href="#l667">667</a><td> * original object if this browser does not support immutables.<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @template K,V<tr><td><a id="l669"></a><a href="#l669">669</a><td> */<tr><td><a id="l670"></a><a href="#l670">670</a><td>goog.object.createImmutableView = function(obj) {<tr><td><a id="l671"></a><a href="#l671">671</a><td> var result = obj;<tr><td><a id="l672"></a><a href="#l672">672</a><td> if (Object.isFrozen &amp;&amp; !Object.isFrozen(obj)) {<tr><td><a id="l673"></a><a href="#l673">673</a><td> result = Object.create(obj);<tr><td><a id="l674"></a><a href="#l674">674</a><td> Object.freeze(result);<tr><td><a id="l675"></a><a href="#l675">675</a><td> }<tr><td><a id="l676"></a><a href="#l676">676</a><td> return result;<tr><td><a id="l677"></a><a href="#l677">677</a><td>};<tr><td><a id="l678"></a><a href="#l678">678</a><td><tr><td><a id="l679"></a><a href="#l679">679</a><td><tr><td><a id="l680"></a><a href="#l680">680</a><td>/**<tr><td><a id="l681"></a><a href="#l681">681</a><td> * @param {!Object} obj An object.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @return {boolean} Whether this is an immutable view of the object.<tr><td><a id="l683"></a><a href="#l683">683</a><td> */<tr><td><a id="l684"></a><a href="#l684">684</a><td>goog.object.isImmutableView = function(obj) {<tr><td><a id="l685"></a><a href="#l685">685</a><td> return !!Object.isFrozen &amp;&amp; Object.isFrozen(obj);<tr><td><a id="l686"></a><a href="#l686">686</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>