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.
- package/CHANGES.md +57 -0
- package/NOTICE +1 -1
- package/README.md +56 -6
- package/builder.js +375 -358
- package/chrome.js +549 -586
- package/edge.js +378 -0
- package/error.js +597 -5
- package/example/google_search_generator.js +2 -4
- package/example/logging.js +6 -2
- package/executors.js +11 -27
- package/firefox/binary.js +79 -87
- package/firefox/extension.js +10 -18
- package/firefox/index.js +173 -173
- package/firefox/profile.js +220 -240
- package/http/index.js +396 -79
- package/http/util.js +35 -35
- package/ie.js +288 -309
- package/index.js +34 -125
- package/io/exec.js +58 -39
- package/io/index.js +54 -48
- package/lib/actions.js +594 -0
- package/lib/by.js +276 -0
- package/lib/capabilities.js +404 -0
- package/lib/{webdriver/command.js → command.js} +88 -72
- package/lib/{webdriver/button.js → devmode.js} +13 -8
- package/lib/events.js +210 -0
- package/lib/firefox/amd64/libnoblur64.so +0 -0
- package/lib/firefox/i386/libnoblur.so +0 -0
- package/lib/firefox/webdriver.json +5 -1
- package/lib/firefox/webdriver.xpi +0 -0
- package/lib/{webdriver/key.js → input.js} +82 -2
- package/lib/logging.js +668 -0
- package/lib/{webdriver/promise.js → promise.js} +688 -644
- package/lib/session.js +79 -0
- package/lib/{webdriver/serializable.js → symbols.js} +11 -16
- package/lib/test/build.js +4 -4
- package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
- package/lib/test/data/click_tests/overlapping_elements.html +15 -4
- package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
- package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
- package/lib/test/data/readOnlyPage.html +1 -1
- package/lib/test/data/selectPage.html +18 -2
- package/lib/test/fileserver.js +3 -4
- package/lib/test/index.js +7 -3
- package/lib/test/resources.js +1 -1
- package/lib/until.js +428 -0
- package/lib/webdriver.js +2351 -0
- package/net/portprober.js +15 -11
- package/opera.js +295 -314
- package/package.json +6 -5
- package/phantomjs.js +135 -140
- package/proxy.js +6 -4
- package/remote/index.js +229 -221
- package/safari.js +319 -310
- package/test/chrome/options_test.js +11 -9
- package/test/element_finding_test.js +51 -13
- package/test/error_test.js +163 -0
- package/test/execute_script_test.js +1 -1
- package/test/http/http_test.js +317 -55
- package/test/http/util_test.js +25 -23
- package/test/io_test.js +6 -1
- package/test/lib/by_test.js +127 -0
- package/test/lib/capabilities_test.js +84 -0
- package/test/lib/events_test.js +177 -0
- package/test/lib/logging_test.js +272 -0
- package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
- package/test/lib/promise_error_test.js +808 -0
- package/test/lib/promise_flow_test.js +2282 -0
- package/test/lib/promise_generator_test.js +308 -0
- package/test/lib/promise_test.js +996 -0
- package/test/lib/testutil.js +90 -0
- package/test/lib/until_test.js +436 -0
- package/test/lib/webdriver_test.js +2207 -0
- package/test/page_loading_test.js +7 -9
- package/test/stale_element_test.js +2 -2
- package/test/testing/assert_test.js +374 -0
- package/test/testing/index_test.js +9 -11
- package/testing/assert.js +334 -17
- package/testing/index.js +10 -0
- package/_base.js +0 -200
- package/docs/Changes.html +0 -356
- package/docs/class_bot_Error.html +0 -15
- package/docs/class_webdriver_ActionSequence.html +0 -115
- package/docs/class_webdriver_Alert.html +0 -24
- package/docs/class_webdriver_AlertPromise.html +0 -92
- package/docs/class_webdriver_Capabilities.html +0 -60
- package/docs/class_webdriver_Command.html +0 -15
- package/docs/class_webdriver_EventEmitter.html +0 -35
- package/docs/class_webdriver_FileDetector.html +0 -21
- package/docs/class_webdriver_Locator.html +0 -12
- package/docs/class_webdriver_Serializable.html +0 -9
- package/docs/class_webdriver_Session.html +0 -13
- package/docs/class_webdriver_TouchSequence.html +0 -49
- package/docs/class_webdriver_UnhandledAlertError.html +0 -18
- package/docs/class_webdriver_WebDriver.html +0 -313
- package/docs/class_webdriver_WebDriver_Logs.html +0 -15
- package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
- package/docs/class_webdriver_WebDriver_Options.html +0 -41
- package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
- package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
- package/docs/class_webdriver_WebDriver_Window.html +0 -27
- package/docs/class_webdriver_WebElement.html +0 -223
- package/docs/class_webdriver_WebElementPromise.html +0 -274
- package/docs/class_webdriver_http_Executor.html +0 -22
- package/docs/class_webdriver_http_Request.html +0 -12
- package/docs/class_webdriver_http_Response.html +0 -13
- package/docs/class_webdriver_logging_Entry.html +0 -15
- package/docs/class_webdriver_logging_Level.html +0 -55
- package/docs/class_webdriver_logging_LogRecord.html +0 -45
- package/docs/class_webdriver_logging_Logger.html +0 -119
- package/docs/class_webdriver_logging_Preferences.html +0 -8
- package/docs/class_webdriver_promise_CancellationError.html +0 -17
- package/docs/class_webdriver_promise_ControlFlow.html +0 -153
- package/docs/class_webdriver_promise_Deferred.html +0 -84
- package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
- package/docs/class_webdriver_promise_Promise.html +0 -75
- package/docs/class_webdriver_stacktrace_Frame.html +0 -20
- package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
- package/docs/class_webdriver_testing_Assertion.html +0 -99
- package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
- package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
- package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
- package/docs/class_webdriver_until_Condition.html +0 -7
- package/docs/dossier.css +0 -1
- package/docs/dossier.js +0 -86
- package/docs/enum_bot_ErrorCode.html +0 -3
- package/docs/enum_bot_Error_State.html +0 -2
- package/docs/enum_webdriver_Browser.html +0 -2
- package/docs/enum_webdriver_Button.html +0 -2
- package/docs/enum_webdriver_Capability.html +0 -33
- package/docs/enum_webdriver_CommandName.html +0 -3
- package/docs/enum_webdriver_Key.html +0 -12
- package/docs/enum_webdriver_logging_Type.html +0 -6
- package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
- package/docs/index.html +0 -125
- package/docs/interface_webdriver_CommandExecutor.html +0 -9
- package/docs/interface_webdriver_http_Client.html +0 -10
- package/docs/interface_webdriver_promise_Thenable.html +0 -77
- package/docs/module_selenium-webdriver.html +0 -23
- package/docs/module_selenium-webdriver__base.html +0 -23
- package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
- package/docs/module_selenium-webdriver_builder.html +0 -2
- package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
- package/docs/module_selenium-webdriver_chrome.html +0 -90
- package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
- package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
- package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
- package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
- package/docs/module_selenium-webdriver_class_Builder.html +0 -138
- package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
- package/docs/module_selenium-webdriver_class_Command.html +0 -15
- package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
- package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
- package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
- package/docs/module_selenium-webdriver_class_Session.html +0 -13
- package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
- package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
- package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
- package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
- package/docs/module_selenium-webdriver_enum_Button.html +0 -2
- package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
- package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
- package/docs/module_selenium-webdriver_enum_Key.html +0 -12
- package/docs/module_selenium-webdriver_error.html +0 -4
- package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
- package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
- package/docs/module_selenium-webdriver_executors.html +0 -10
- package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
- package/docs/module_selenium-webdriver_firefox.html +0 -68
- package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
- package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
- package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
- package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
- package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
- package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
- package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
- package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
- package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
- package/docs/module_selenium-webdriver_http.html +0 -9
- package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
- package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
- package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
- package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
- package/docs/module_selenium-webdriver_http_util.html +0 -17
- package/docs/module_selenium-webdriver_ie.html +0 -11
- package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
- package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
- package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
- package/docs/module_selenium-webdriver_io.html +0 -37
- package/docs/module_selenium-webdriver_io_exec.html +0 -6
- package/docs/module_selenium-webdriver_namespace_By.html +0 -56
- package/docs/module_selenium-webdriver_namespace_error.html +0 -4
- package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
- package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
- package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
- package/docs/module_selenium-webdriver_namespace_until.html +0 -82
- package/docs/module_selenium-webdriver_net.html +0 -7
- package/docs/module_selenium-webdriver_net_portprober.html +0 -12
- package/docs/module_selenium-webdriver_opera.html +0 -62
- package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
- package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
- package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
- package/docs/module_selenium-webdriver_phantomjs.html +0 -2
- package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
- package/docs/module_selenium-webdriver_proxy.html +0 -28
- package/docs/module_selenium-webdriver_remote.html +0 -8
- package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
- package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
- package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
- package/docs/module_selenium-webdriver_safari.html +0 -9
- package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
- package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
- package/docs/module_selenium-webdriver_testing.html +0 -74
- package/docs/module_selenium-webdriver_testing_assert.html +0 -9
- package/docs/namespace_bot.html +0 -4
- package/docs/namespace_bot_json.html +0 -20
- package/docs/namespace_bot_response.html +0 -18
- package/docs/namespace_bot_userAgent.html +0 -33
- package/docs/namespace_webdriver.html +0 -30
- package/docs/namespace_webdriver_By.html +0 -56
- package/docs/namespace_webdriver_http.html +0 -6
- package/docs/namespace_webdriver_logging.html +0 -70
- package/docs/namespace_webdriver_promise.html +0 -688
- package/docs/namespace_webdriver_stacktrace.html +0 -17
- package/docs/namespace_webdriver_testing.html +0 -7
- package/docs/namespace_webdriver_testing_assert.html +0 -9
- package/docs/namespace_webdriver_testing_asserts.html +0 -18
- package/docs/namespace_webdriver_until.html +0 -82
- package/docs/source/_base.js.src.html +0 -1
- package/docs/source/builder.js.src.html +0 -1
- package/docs/source/chrome.js.src.html +0 -1
- package/docs/source/error.js.src.html +0 -1
- package/docs/source/executors.js.src.html +0 -1
- package/docs/source/firefox/binary.js.src.html +0 -1
- package/docs/source/firefox/extension.js.src.html +0 -1
- package/docs/source/firefox/index.js.src.html +0 -1
- package/docs/source/firefox/profile.js.src.html +0 -1
- package/docs/source/http/index.js.src.html +0 -1
- package/docs/source/http/util.js.src.html +0 -1
- package/docs/source/ie.js.src.html +0 -1
- package/docs/source/index.js.src.html +0 -1
- package/docs/source/io/exec.js.src.html +0 -1
- package/docs/source/io/index.js.src.html +0 -1
- package/docs/source/lib/atoms/error.js.src.html +0 -1
- package/docs/source/lib/atoms/json.js.src.html +0 -1
- package/docs/source/lib/atoms/response.js.src.html +0 -1
- package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
- package/docs/source/lib/goog/array/array.js.src.html +0 -1
- package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
- package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
- package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
- package/docs/source/lib/goog/async/run.js.src.html +0 -1
- package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
- package/docs/source/lib/goog/base.js.src.html +0 -1
- package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
- package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
- package/docs/source/lib/goog/debug/error.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
- package/docs/source/lib/goog/deps.js.src.html +0 -1
- package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
- package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
- package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
- package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
- package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
- package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
- package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
- package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
- package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
- package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
- package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
- package/docs/source/lib/goog/events/event.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
- package/docs/source/lib/goog/events/events.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
- package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
- package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
- package/docs/source/lib/goog/events/listener.js.src.html +0 -1
- package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
- package/docs/source/lib/goog/fs/url.js.src.html +0 -1
- package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
- package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
- package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
- package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
- package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
- package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
- package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
- package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
- package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
- package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
- package/docs/source/lib/goog/json/json.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
- package/docs/source/lib/goog/log/log.js.src.html +0 -1
- package/docs/source/lib/goog/math/box.js.src.html +0 -1
- package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
- package/docs/source/lib/goog/math/math.js.src.html +0 -1
- package/docs/source/lib/goog/math/rect.js.src.html +0 -1
- package/docs/source/lib/goog/math/size.js.src.html +0 -1
- package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
- package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
- package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
- package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
- package/docs/source/lib/goog/object/object.js.src.html +0 -1
- package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
- package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
- package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
- package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
- package/docs/source/lib/goog/string/const.js.src.html +0 -1
- package/docs/source/lib/goog/string/string.js.src.html +0 -1
- package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
- package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
- package/docs/source/lib/goog/structs/map.js.src.html +0 -1
- package/docs/source/lib/goog/structs/set.js.src.html +0 -1
- package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
- package/docs/source/lib/goog/style/style.js.src.html +0 -1
- package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
- package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
- package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
- package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
- package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
- package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
- package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
- package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
- package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
- package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
- package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
- package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
- package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
- package/docs/source/lib/webdriver/button.js.src.html +0 -1
- package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
- package/docs/source/lib/webdriver/command.js.src.html +0 -1
- package/docs/source/lib/webdriver/events.js.src.html +0 -1
- package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
- package/docs/source/lib/webdriver/key.js.src.html +0 -1
- package/docs/source/lib/webdriver/locators.js.src.html +0 -1
- package/docs/source/lib/webdriver/logging.js.src.html +0 -1
- package/docs/source/lib/webdriver/promise.js.src.html +0 -1
- package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
- package/docs/source/lib/webdriver/session.js.src.html +0 -1
- package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
- package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
- package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
- package/docs/source/lib/webdriver/until.js.src.html +0 -1
- package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
- package/docs/source/net/index.js.src.html +0 -1
- package/docs/source/net/portprober.js.src.html +0 -1
- package/docs/source/opera.js.src.html +0 -1
- package/docs/source/phantomjs.js.src.html +0 -1
- package/docs/source/proxy.js.src.html +0 -1
- package/docs/source/remote/index.js.src.html +0 -1
- package/docs/source/safari.js.src.html +0 -1
- package/docs/source/testing/assert.js.src.html +0 -1
- package/docs/source/testing/index.js.src.html +0 -1
- package/docs/types.js +0 -1
- package/lib/atoms/error.js +0 -202
- package/lib/atoms/json.js +0 -80
- package/lib/atoms/response.js +0 -110
- package/lib/atoms/userAgent.js +0 -257
- package/lib/goog/LICENSE +0 -176
- package/lib/goog/array/array.js +0 -1654
- package/lib/goog/asserts/asserts.js +0 -365
- package/lib/goog/async/freelist.js +0 -88
- package/lib/goog/async/nexttick.js +0 -241
- package/lib/goog/async/run.js +0 -133
- package/lib/goog/async/workqueue.js +0 -139
- package/lib/goog/base.js +0 -2548
- package/lib/goog/debug/debug.js +0 -653
- package/lib/goog/debug/entrypointregistry.js +0 -158
- package/lib/goog/debug/error.js +0 -63
- package/lib/goog/debug/logbuffer.js +0 -148
- package/lib/goog/debug/logger.js +0 -873
- package/lib/goog/debug/logrecord.js +0 -242
- package/lib/goog/deps.js +0 -151
- package/lib/goog/disposable/disposable.js +0 -307
- package/lib/goog/disposable/idisposable.js +0 -45
- package/lib/goog/dom/browserfeature.js +0 -72
- package/lib/goog/dom/dom.js +0 -2991
- package/lib/goog/dom/nodetype.js +0 -48
- package/lib/goog/dom/safe.js +0 -347
- package/lib/goog/dom/tagname.js +0 -160
- package/lib/goog/dom/tags.js +0 -41
- package/lib/goog/dom/vendor.js +0 -96
- package/lib/goog/events/browserevent.js +0 -400
- package/lib/goog/events/browserfeature.js +0 -85
- package/lib/goog/events/event.js +0 -143
- package/lib/goog/events/eventid.js +0 -47
- package/lib/goog/events/events.js +0 -984
- package/lib/goog/events/eventtarget.js +0 -394
- package/lib/goog/events/eventtype.js +0 -237
- package/lib/goog/events/keycodes.js +0 -427
- package/lib/goog/events/listenable.js +0 -335
- package/lib/goog/events/listener.js +0 -131
- package/lib/goog/events/listenermap.js +0 -308
- package/lib/goog/fs/url.js +0 -109
- package/lib/goog/functions/functions.js +0 -442
- package/lib/goog/html/safehtml.js +0 -757
- package/lib/goog/html/safescript.js +0 -234
- package/lib/goog/html/safestyle.js +0 -442
- package/lib/goog/html/safestylesheet.js +0 -276
- package/lib/goog/html/safeurl.js +0 -398
- package/lib/goog/html/trustedresourceurl.js +0 -224
- package/lib/goog/html/uncheckedconversions.js +0 -232
- package/lib/goog/i18n/bidi.js +0 -908
- package/lib/goog/iter/iter.js +0 -1302
- package/lib/goog/json/json.js +0 -363
- package/lib/goog/labs/testing/assertthat.js +0 -58
- package/lib/goog/labs/testing/logicmatcher.js +0 -212
- package/lib/goog/labs/testing/matcher.js +0 -80
- package/lib/goog/labs/testing/numbermatcher.js +0 -346
- package/lib/goog/labs/testing/objectmatcher.js +0 -317
- package/lib/goog/labs/testing/stringmatcher.js +0 -415
- package/lib/goog/labs/useragent/browser.js +0 -341
- package/lib/goog/labs/useragent/engine.js +0 -160
- package/lib/goog/labs/useragent/platform.js +0 -160
- package/lib/goog/labs/useragent/util.js +0 -148
- package/lib/goog/log/log.js +0 -197
- package/lib/goog/math/box.js +0 -398
- package/lib/goog/math/coordinate.js +0 -268
- package/lib/goog/math/math.js +0 -451
- package/lib/goog/math/rect.js +0 -476
- package/lib/goog/math/size.js +0 -227
- package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
- package/lib/goog/net/xhrlike.js +0 -124
- package/lib/goog/net/xmlhttp.js +0 -246
- package/lib/goog/net/xmlhttpfactory.js +0 -67
- package/lib/goog/object/object.js +0 -686
- package/lib/goog/promise/promise.js +0 -1350
- package/lib/goog/promise/resolver.js +0 -48
- package/lib/goog/promise/thenable.js +0 -126
- package/lib/goog/reflect/reflect.js +0 -77
- package/lib/goog/string/const.js +0 -182
- package/lib/goog/string/string.js +0 -1599
- package/lib/goog/string/typedstring.js +0 -48
- package/lib/goog/structs/collection.js +0 -56
- package/lib/goog/structs/map.js +0 -457
- package/lib/goog/structs/set.js +0 -279
- package/lib/goog/structs/structs.js +0 -354
- package/lib/goog/style/style.js +0 -2037
- package/lib/goog/testing/asserts.js +0 -1278
- package/lib/goog/testing/events/events.js +0 -767
- package/lib/goog/testing/functionmock.js +0 -175
- package/lib/goog/testing/jsunit.js +0 -162
- package/lib/goog/testing/loosemock.js +0 -242
- package/lib/goog/testing/mock.js +0 -645
- package/lib/goog/testing/mockclock.js +0 -606
- package/lib/goog/testing/mockcontrol.js +0 -220
- package/lib/goog/testing/mockinterface.js +0 -45
- package/lib/goog/testing/mockmatchers.js +0 -400
- package/lib/goog/testing/objectpropertystring.js +0 -68
- package/lib/goog/testing/propertyreplacer.js +0 -262
- package/lib/goog/testing/recordfunction.js +0 -215
- package/lib/goog/testing/stacktrace.js +0 -594
- package/lib/goog/testing/strictmock.js +0 -130
- package/lib/goog/testing/testcase.js +0 -1629
- package/lib/goog/testing/testrunner.js +0 -440
- package/lib/goog/uri/uri.js +0 -1524
- package/lib/goog/uri/utils.js +0 -1064
- package/lib/goog/useragent/product.js +0 -183
- package/lib/goog/useragent/product_isversion.js +0 -144
- package/lib/goog/useragent/useragent.js +0 -572
- package/lib/webdriver/actionsequence.js +0 -356
- package/lib/webdriver/builder.js +0 -207
- package/lib/webdriver/capabilities.js +0 -412
- package/lib/webdriver/events.js +0 -179
- package/lib/webdriver/firefoxdomexecutor.js +0 -175
- package/lib/webdriver/http/corsclient.js +0 -133
- package/lib/webdriver/http/http.js +0 -525
- package/lib/webdriver/http/xhrclient.js +0 -67
- package/lib/webdriver/locators.js +0 -257
- package/lib/webdriver/logging.js +0 -347
- package/lib/webdriver/session.js +0 -74
- package/lib/webdriver/stacktrace.js +0 -619
- package/lib/webdriver/test/builder_test.js +0 -53
- package/lib/webdriver/test/capabilities_test.js +0 -72
- package/lib/webdriver/test/events_test.js +0 -203
- package/lib/webdriver/test/http/corsclient_test.js +0 -151
- package/lib/webdriver/test/http/http_test.js +0 -428
- package/lib/webdriver/test/http/xhrclient_test.js +0 -196
- package/lib/webdriver/test/locators_test.js +0 -59
- package/lib/webdriver/test/logging_test.js +0 -85
- package/lib/webdriver/test/promise_error_test.js +0 -892
- package/lib/webdriver/test/promise_flow_test.js +0 -2365
- package/lib/webdriver/test/promise_generator_test.js +0 -323
- package/lib/webdriver/test/promise_test.js +0 -2012
- package/lib/webdriver/test/stacktrace_test.js +0 -480
- package/lib/webdriver/test/test_bootstrap.js +0 -67
- package/lib/webdriver/test/testing/asserts_test.js +0 -117
- package/lib/webdriver/test/testing/client_test.js +0 -88
- package/lib/webdriver/test/testing/testcase_test.js +0 -229
- package/lib/webdriver/test/testutil.js +0 -209
- package/lib/webdriver/test/testutil_test.js +0 -104
- package/lib/webdriver/test/until_test.js +0 -411
- package/lib/webdriver/test/webdriver_generator_test.js +0 -92
- package/lib/webdriver/test/webdriver_test.js +0 -2369
- package/lib/webdriver/testing/asserts.js +0 -487
- package/lib/webdriver/testing/client.js +0 -179
- package/lib/webdriver/testing/jsunit.js +0 -363
- package/lib/webdriver/testing/testcase.js +0 -168
- package/lib/webdriver/testing/window.js +0 -244
- package/lib/webdriver/touchsequence.js +0 -248
- package/lib/webdriver/until.js +0 -412
- package/lib/webdriver/webdriver.js +0 -2511
- 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 "License");<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 "AS-IS" 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('goog.math.Size');<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 && 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 '(' + this.width + ' x ' + this.height + ')';<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'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'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 <= target.width && this.height <= 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() <= 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() > 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 "License");<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 "AS-IS" 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('goog.net.WrapperXmlHttpFactory');<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('goog.net.XhrLike');<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require('goog.net.XmlHttpFactory');<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 "License");<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 "AS-IS" 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('goog.net.XhrLike');<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 "License");<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 "AS-IS" 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('goog.net.DefaultXmlHttpFactory');<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide('goog.net.XmlHttp');<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide('goog.net.XmlHttp.OptionType');<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide('goog.net.XmlHttp.ReadyState');<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide('goog.net.XmlHttpDefines');<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('goog.asserts');<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require('goog.net.WrapperXmlHttpFactory');<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require('goog.net.XmlHttpFactory');<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('goog.net.XmlHttp.ASSUME_NATIVE_XHR', 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('goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR', 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'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'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'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 '';<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_ && typeof XMLHttpRequest == 'undefined' &&<tr><td><a id="l218"></a><a href="#l218">218</a><td> typeof ActiveXObject != 'undefined') {<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 = ['MSXML2.XMLHTTP.6.0', 'MSXML2.XMLHTTP.3.0',<tr><td><a id="l221"></a><a href="#l221">221</a><td> 'MSXML2.XMLHTTP', 'Microsoft.XMLHTTP'];<tr><td><a id="l222"></a><a href="#l222">222</a><td> for (var i = 0; i < 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't find any matches<tr><td><a id="l237"></a><a href="#l237">237</a><td> throw Error('Could not create ActiveXObject. ActiveX might be disabled,' +<tr><td><a id="l238"></a><a href="#l238">238</a><td> ' or MSXML might not be installed');<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 "License");<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 "AS-IS" 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('goog.net.XmlHttpFactory');<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('goog.net.XhrLike');<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 "License");<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 "AS-IS" 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('goog.object');<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<K,V>} 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<K,V>):?} 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 'this' 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<K,V>} 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<K,V>):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 'this' object within f.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {!Object<K,V>} 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<K,V>} 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<K,V>):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 'this' object within f.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {!Object<K,R>} 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<K,V>} obj The object to check.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {function(this:T,V,?,Object<K,V>):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 'this' 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<K,V>} obj The object to check.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @param {?function(this:T,V,?,Object<K,V>):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 'this' 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<K,V>} 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<K,V>} 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<K,V>} obj The object from which to get the values.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {!Array<V>} 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<string>} 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, 'foo', 'entries', 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<number|string>)} 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 < 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 && 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<K,V>} 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<K,V>} 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<K,V>):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 "this" 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<K,V>} 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<K,V>):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 "this" 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 && 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<K,V>} 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 && key in obj) {<tr><td><a id="l386"></a><a href="#l386">386</a><td> throw Error('The object already contains the key "' + key + '"');<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<K,V>} 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 && 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<K,V>} 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'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<K,V>} 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'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<K,V>} 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'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<K,V>} a<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @param {!Object<K,V>} 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<K,V>} obj Object to clone.<tr><td><a id="l489"></a><a href="#l489">489</a><td> * @return {!Object<K,V>} 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> * <code>goog.object.unsafeClone</code> 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> * <code>goog.object.unsafeClone</code> is unaware of unique identifiers, and<tr><td><a id="l514"></a><a href="#l514">514</a><td> * copies UIDs created by <code>getUid</code> 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 == 'object' || type == 'array') {<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 == 'array' ? [] : {};<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<string>}<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> 'constructor',<tr><td><a id="l560"></a><a href="#l560">560</a><td> 'hasOwnProperty',<tr><td><a id="l561"></a><a href="#l561">561</a><td> 'isPrototypeOf',<tr><td><a id="l562"></a><a href="#l562">562</a><td> 'propertyIsEnumerable',<tr><td><a id="l563"></a><a href="#l563">563</a><td> 'toLocaleString',<tr><td><a id="l564"></a><a href="#l564">564</a><td> 'toString',<tr><td><a id="l565"></a><a href="#l565">565</a><td> 'valueOf'<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 'in-place'; 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 < 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 'replace' on objects that<tr><td><a id="l596"></a><a href="#l596">596</a><td> // extend String and change 'replace' (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 < 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 && 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('Uneven number of arguments');<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 < 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 && 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 < 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<K,V>} obj An object.<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @return {!Object<K,V>} 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 && !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 && 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>
|